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1 Introduction 

Welcome to ASM-ONE! This program is an integrated envi- 
ronment including assembler, editor, debugger and monitor. 
Including all necessary functions in one tool makes program 
development both faster and more user friendly. You can write 
any type and size of program with this assembler, the only 
restriction is the available memory. 

Short overview of the ASM-ONE macro assembler: 

Integrated source level debugger: With ability to single step 
the program while watching the contents of memory locati- 
ons, setting breakpoints, full register watch, register editing. 

Compatibility with ALink and BLink: This enables high level 
language programmers to use machine language routines 
in their programs. 

Fast assembling rate of 50000 - 70000 lines each minute. 

Compatibility with all previous assemblers. Porting sources 
, from earlier assemblers should not be any problem. 

Many extra directives allowing more user-friendly source 
generation. 

Integrated superfast editor with block, search, replace, mark 
and macro functions. 

Real time full screen monitor with disassemble, hex dump, 
ASCII dump, address mark and jump. 

User-friendly with menus including shortcuts on all items. 

Optional absolute memory allocation makes this assembler 
ideal as game or demo developing tool. 

Binary file support, with INCBIN and >EXTERN. 
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1.1 Intentions of this program 

Programming in assembler is an activity which requires more 
attention to minute details than, any other programming lan- 
guage. On the other hand it is possible to write a program that 
takes advantage of each of the processor instructions, this 
results in faster programs. Because programming is such an 
intensive activity, it is important that the programming tools are 
as fast and as flexible as possible. This is why ASM-ONE is 
integrated with assembler, editor, monitor and debugger. In 
this way you save time. All functions can be accessed from 
both menus and from the keyboard, the keyboard is recom- 
mended when you get used to this program. 

ASM-ONE is meant as both a system- and as a game or 
demo programming tool. This means that it is macro as- 
sembler compatible with include files, sections and so on, and 
it also supports direct memory placement, monitor functions 
etc. for non-system programmers. Both ways are supported 
without excluding any part of the other. 



1 .2 The ASM-ONE Macro Assembler 

To use this program it is necessary to understand the basic 
functions of it. 

The base of the program is the command line. You enter this 
after having choosen the type and size of your workspace. 
From -here you can select any command or mode known to 
ASM-ONE. This is shown schematically below. 
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ASM-ONE structure: 





Command Line 


















Editor 


| Assembler 


Debugger 


Monitor 



When creating a program the process is as follows: , 

1 . Write or load your program text file into the editor. 

2. Assemble it and if errors occur, return to the editor (1). 

3. Try to run it. If you discover any bugs correct these in the 
source in the editor (1). Or if you cannot find the errors 
directly enter the debugger. 

Note: Before running any part of a newly written program, you 
should make a safety backup, because activating an assem- 
bly program gives complete control to that program. 
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2. Installing the assembler 

The disk supplied in this package can auto-boot. In this way it 
is possible for you to see your. new program fast. But after 
having made the first tests you might want to start it from 
workbench, use a printer or install the program on your hard- 
disk. 

For future program execution you will have to -choose one of 
the following 2 possibilities: 

1. Auto-booting as first time 

2. Booting from workbench 



2.1 Auto-booting as first time 

if you want to use your printer after auto-booting from the 
ASM-ONE disk, you will have to copy the following files from 
the Workbench disk onto the ASM-ONE boot disk: 

Copying these files programs on a computer or from a disk 
carrying a virus might damage the ASM-ONE boot disk. If you 
are not sure that your computer and workbench disk are virus 
free go to 2.2. 



devs/ serial . device to 


devs/ 


devs /parallel .device to 


devs/ 


devs /pr iixte r . device to 


devs/ 


devs/system-configuration to 


devs/ 


devs/printers/<ihr Drucker> to 


devs /printers / 


1 /Port -Handler to 


1/ 
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Be sure that »your printer« is the one choosen in the system 
configuration. You can do that by running the program called 
preferences. Consult your Amiga reference manual on how to 
check this. 

The easier thing to do is just copying the entire »devs/« and 
»l/« directories onto the ASM-ONE boot disk. 

This is the hardest way because you will have to copy most 
files. But maybe the most convenient afterwards because 
everything is on one disk. But if you are not totally sure of how (_ 

to do this go to 2.2. 



2.2 Booting from workbench 

This is much easier to do than the above method. Because 
you just have to copy the following file from the ASM-ONE 
boot disk to the workbench disk: 

libs /req. library to libs/ 

Now you can boot your workbench as usual, insert the ASM- 
ONE boot disk and click the ASM-ONE load symbol. 



c 



12 



Getting started 



3. Getting started 

After having loaded the program {see chapter 2) you are met 
with the following prompt: 

ALLOCATE Fast/Chip/Abs> 

If you got fast memory write »F« otherwise »C« and press 
»Return«. Now you are asked how much memory you want. 
(This is the memory for both your source code and the 
assembled program): 

WORKSPACE (max.???) Kb> 

Type the amount and press return. (100 kb is sufficient for the 
examples on the disk). You have now entered the command 
line and are met with the prompt: 



This means that the choice is yours. From here you start doing 
what you want. To get started you can load from the 
»Examples« directory »GettingStarted.S«. Choose the read 
file item from the »Pro]ect« menu. A big file requester will be 
opened. Click on the »Examples« directory and double click 
on the »GettingStarted.S« file. 

The file is now loaded, if you would like to watch it before run- 
ning it select »Edit« in the »Assembler« menu. Now you can 
use all the options in the » Edit Funct.« menu. To exit the 
editor, press »Esc« or select »Exit« in the » Edit Funct.« menu. 
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You are back in the command line. Assemble the program by 
typing: .■'.." 

>a 

Press »Return«. The response will be:- ■"".-:■ 

Passl. . 
Pass2. . 

No Errors '..■';' 

> ■■.;.■■■■ ' ■ . 

To start the program type:' 
>j 

Press »Retum«. Now the program is running, press »Space« 
to exit the program. " 

You can try to assemble the. rest of the programs in the 
examples directory. Try to look through the different menus. 
To activate not activated menus, select »Editor«, » Debugger 
or,. >> Monitors in the »Assembler« menu, , . , 

If you already know something about machine code, skip the 
beginners chapter. ■ •.'•-'■".■: 

Good luck with your new programming tool! 
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4. Beginners chapter ,. . . 

If you already know something about machine code (you have 
tried to code before) you can skip this chapter, it is meant as 
an basic introduction to the language and also an introduction 
to different systems of arithmetical notation. 



4.1 Why machine code? 

The main reason is that, machine language, is the only lan- 
guage the MC68000, processor understands.. You can create 
programs; in Basic and. .in <.C, but both languages have to be 
translated into machine code before the computer can run 
them. In. Basic the program is translated One line' at a time 
while it .is running. Of course this takes. time. In C the entire 
program lis translated at once. But because each command is 
translated into several machine code commands it-is not pos- 
sible to put the commands together in the most efficient way.' 
This can only be done in machine code.. 

Another explanation can also be given. If you want to under- 
stand how the machine works (what different parts of the 
hardware do), machine code is a very good. way to do this. 
With machine code you can access any part of the machine in 
exactly the way you want. That is why most games are written 
directly in machine code. Many user programs are also written 
directly in machine code (like this assembler). People who 
write 'programs' in other languages than machine code often 
have to write small parts of their programs in this code to solve 
otherwise unsolvable' problems or to increase speed. 



15 



ASM-ONE 



I personally have always chooser) machine language above 
all other languages because I like to have complete control 
over the machine and I enjoy speedy programs. 



4.2 The machine 

This Amiga (and most other computers) is based on the same 
concept. It has a central processing unit (MC68000), a main 
storage {Random Access Memory, RAM), some special pur- (__ 

pose chips (the Amiga has become famous because it was 
born with unusually many help chips: Agnus (can create ani- 
mations etc.), Denise (graphics in 4096 colors), Paufa (4 
channel sound and control of external devices). The Amiga 
also got an operating system placed in ROM (Read Only Me- 
mory). The operating system is actually just a program, which 
takes cafe of nearly anything that takes place in the computer. 
It loads your program, controls the mouse, and place the 
arrow at the right place on the screen. The screen and all 
other graphics on it are also drawn by the operating system. 

The operating system takes up 256 kilo bytes (256 kb). 
Actually 256 kb is not exactly 256 000 bytes but 262144 
bytes. This is because that the machine uses wires carrying 5 
volt or volt (hi or low). To access 1000 bytes it uses 10 wires. 
With 10 wires it is possible to address 

2 A 10 = 2*2*2*2*2*2*2*2*2*2 = 1024 bytes 

instead of. just 1000 bytes as you might have expected. The 
main memory of your computer (if you have 512 kb) is 
512*1024 = 524288 bytes long. Each byte consists of 8 bits. 
A bit can contain only two values, 1 or (high or low). This 
means that a byte can contain 2 A 8 = 256 different values, 
normally interpreted as to 255 but also as -128 to 127. 
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4.3 Systems of arithmetical notation 

Maybe without you noticing it, you have already been introdu- 
ced to a new arithmetical notation. I have mentioned bits 
carrying vaiues and'1, in the normal decimal notation each 
position in a number can be from to 9. The binary notation 
is different in the way that it has only two possibilities on each 
position (0 and 1). Let's take the following number: 

n = %1G0111 ( % means binary ) 

To translate this value into decimal, try to use the build in 

calculator in the assembler. Just type: 

>?%100111 
The result will be: 

Hex Decimal ASCII Binary 

$00000027 39 "...'" %00000000 . 00000000. 00000000 .00100111 

As you see »%100111« is equal to the decimal value »39«. 

Another more theoretical way to do this is as follows: 

A normal decimal number is put together by ones, tens, hun- 
dreds etc. A binary number is put together by 1, 2, 4 etc. So 
to translate the binary value into a decimal value, do like this: - 

% 1 1 1 1 = 1*32 + 0*16 + 0*8 + 1*4 + 1*2 + 1*1 = 39 

To convert the other way is also possible: . 

39 = 39/32 =1*32+7 

7/16 =0*16 +7 

7/8 =0*8+7 

7/4 =1*4+3 

3/2 =1*2+1 

1/1 =1*1+0 
= %100111 
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As you see, it is a little more difficult to translate the other way 
around. One bad thing about binary numbers is that they are 
much longer and, therefore harder to read than decimal num- 
bers. We have to use them because that this is the way num- 
bers are stored in a computer. 

To make the binary numbers easier to read we normally use 
hexadecimal notation. In hex each number can be from to 
15, the numbers 10 to 15 are a problem so we call them >>A« 
to »F« like this: 



Decimal Hexadecimal 


Decimal Hexadecimal 


Decimal Hexadecimal 


= 


6 = 6 


12 = c 


1 = 1 


7 = 7 


13 = d 


2 = 2 


8 = 8 


14 = e 


3 = 3 


9 = 9 


15 = f 


4 = 4 


10 = a 




5 = 5 


11 =b 





Let's take the binary number from before: 

n = %001 00111 
The binary number can easily be converted into hex: 



0000 = 


0100 = 4 


1000 = 8 


1100 = c 


0001 = 1 


0101 = 5 


1001 =9 


1101 =d 


0010 = 2 


0110 = 6 


1010 = a 


1110 = e 


0011 =3 


0111 =7 


1011 = b 


1111 = f 



So »%001 001 1 1 « is »$27«. 

It is possible to create all sorts of different arithmetical nota- 
tion, but the three systems you have learned now are the 
most used. 
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4.4 Memory map. 

Each byte has its own address. You could access address 
300000. This would be in the chip memory (the memory 
where you can show graphics and play sound). Here follows a 
simple. map of your memory: 



$000000 


-$07ff ff 


Chip memory 


$080000 


-$lff f ff 


Expansion area" for chip memory 


$200000 


-$9ff f f f 


1 Expansion area for fast memory 


$a00000 


-$bef f f f 


! Reserved 


$bfd000 


-$bfdf00 


PIA B even addresses 


$bfe001- 


-$bfef 01 


! PIA A odd addresses 


$c00000- 


-$c7f f f f 


i Expansion RAM area Amiga 500 


$c80000 


-$dfef f f 


Reserved 


$df fOOO- 


-$df f f f f 


Hardware registers for special chips 


$e00000- 


-$e7f f f f 


Reserved 


$e80000- 


-$ef f fff 


External area 


$£00000- 


-$f7ff f f 


Expansion ROM 


$£80000 


-$fbf f f f 


Future kickstart ROM 


$fc0000 


-$£ £ ff ff 


Kickstart ROM 



As you can see it is possible to expand your main memory up 
to 10 mega bytes. But to get the extra 1.5 mega bytes of chip 
memory you must buy the new Super Fat Agnus. 
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4.5 The program 

To store your program you use the main memory. The pro- 
gram is stored as a long list of numbers (a serie of zeros and 
ones), each number has its own meaning to the processor. 
These numbers are instructions. Each ■ instruction can consist 
of 2 to 1 bytes. 

One of the shortest instructions is the RTS (Return From 
Subroutine), it has the value %01 001 1 1 001 1 1 01 01 in binary, Q 

$4e75 in hex and 20085 in decimal. Most instructions are 
much more complicated, because they can have various 
operands. 

It is impossible to remember all these numbers so that is why 
you use an assembler. The assembler understands the 
name of all the possible commands. So if you write »RTS«, 
the assembler will automatically translate this into the number 
$4e75 as mentioned before. 

There are of course many other commands, but it is possible 
to make a little program without knowing them all. 

Two new commands: 

MOVE <source>,<destination> 

ADD <source>,<destination> 

The move command will move the source value to the desti- 
nation address. The add command will add the source value (_ 
to the content of the destination address. 

With these two commands you can now make your first pro- 
gram. To do this you will have to enter the editor. But first 
delete everything in the editor. 

To delete everything choose the »Zap Source« command in 
the project menu. 
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Now enter the editor by pressing »Esc«. . 

A simple program made with the three above commands 
could be: 

START MOVE.L #0, $000000 , ; Zero the address 

; (32 bit) 

ADD.L #$1234, $000000 ; Add $1234 

; to the address 

RTS 

After typing the program into the editor leave it by pressing 
»Esc« again, and try to assemble by typing: 

>A 

The result should be: 

Pass 1. . 

Pass 2. . ■ !■ v... 

No Errors 

> 

If you get any error message, enter the editor and find and 
correct the bug. After having assembled your program 
successfully, run it by typing: 

>J 

To see the result in the memory type: 
>h.l 

The first line of your output wii) look something like this: 

00000000 00001234 00000676 00 



The first column you see is the address you are looking at in 
the memory. The next value is »00001234«. This is the con- 
tent of address »zero«. 
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This is correct. If you look at the program again you will see 
that the value zero is written into address » 00000000 «. And 
next the value »$1234« is added to to content of address 
»00000000«. What has happend is that the value »0+$1234« 
is put into the address »00000000«. 



4.6 The registers 

When you are making a program you will often use a value in v. 

a calculation or a counter. You could use a memory address 
to store to number, but if you use this value a lot you could 
use a register instead, because this is faster. The registers are 
like memory addresses but they are kept inside the processor. 
On the MC68000 we have 15 different registers that are 
available to the user. 

These registers are of two main classes: 

D0-D7 Data registers 32 Bit 

A0-A6 Address registers 32 Bit 

The data registers are the most flexible ones. They can be 
accessed as both bytes (8 bit), words (16 bit) or longwords (32 
bits). You can make all sort of logical or arithmetical operations 
on these registers. The address registers can only be acces- 
sed as words and longwords, but can be used as pointers to 
data in memory. C 

We could take the addition from before; but this time just do 
the calculation in the data registers instead of the memory. 

START MOVE.L #0,D0 , ; Zero DO (32 bit) 
ADD.L #$1234, DO ; Add $1234 to DO 

RTS 
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Assemble and run; this little example like before. Now watch 
the register »D0« when the routine has been executed. 

You see something like this: 

01:00001234 00000000 00000000 00000000 00000000 00000000 00000000 
fC -.00000000 00000000 00000000 00000000 00000000 00000000 00012345 

The number just after »D0:« is the contents of register »,D0« 
the next value is »D1« etc. Just watch »D0«, you see.?? 

We could try to make an more advanced example where we 
use the address registers together with some new commands. 

The new commands are: 

LEA load effective address 

TST test If operand is zero 

BEQ branch if result is zero 

BRA branch always (like GOTO in Basic) 

So here is the program; what does it do? 



S TART LEA . L BUFFER , A0 



Put buffer 
adress into AO 



LOOP TST.B (A0) 

BEQ END 

ADD.B #1, (A0) 

ADD.L #1,A0 

BRA LOOP 

END RTS 



Test if A0 points 
to value 
if then end 
add 1 to the adress 
A0 points to 
add 1 to the 
pointer A0 
Branch to loop. 
Do it again. 



Return from subroutine 



BUFFER DC.B ' G KKN',0 



The buffer with 
the secret text 
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Try to assemble and run it with »J«. Try to type »H.BUFFER«, 
look at the char dump to the right. If the program is correct 
there should be a little message for you. 

There was another new statement in this program (the DC.B). 
This is not a machine code command, but it tells the as- 
sembler to put the constant value that follows this statement 
into memory. So you could write: 

DC.W 1000 

This would put the constant value »1000« into memory. As 

you see in the above example it is also possible to put text 
into memory. This is because each character is converted into 
a number. These numbers are called ASCII codes. This is a 
standard way to translate characters into numbers and vice 
versa. To list the entire ASCII table would take up too much 
space, but some examples can be given: 



= $30 


A = $41 


a = $61 


. = $2e 


1 =$31 


B = $42 


b = $62 


■ ; = $3b 


2 = $32 


C = $43 


c = $63 


? = $3f 


3 = $33 


D = $44 


d = $64 





If you want to know the numbers of other ASCII numbers the 
build in calculator is capable of translating characters into 
numbers: 

>?'A' 



This will give you: 

Hex Decimal ASCil 



C 



c 



Binary 



$0 0000041 65 



". ..A" %00000000. 0000000 0. 00000000 .01000001 



So far, some of the principles of machine language have 
been explained to you. If you want to know more about the 
processor, read the chapter »The Motorola MC68000«. 
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5 The Editor 

The buildt-in editor is fast, it has a text output of more than 
30000 characters per second. It also supports a lot of helpful 
block operations and cursor manipulations. 

To enter the editor select »Edit« in the »Assembler« menu, or 
press »Amiga-Shift-E« or just »Esc«. To open a half sized 
editor window press »Ctrl-Esc« instead of just »Esc«. 

From the editor mode you can use all the functions listed in 
the »Edit Funct« menu or use a shortcut (»Amiga«, »Ctrl«, 
»Shift«, »Alt« + a key) to activate the command. To enable 
you to activate most of the key commands with one hand, the 
» Ctrl « key can be used as well as the normal » Amiga « key. 
A big letter in the menu specifies that you will also have to 
press »Shift« to get this function. 
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5.1 Summary of editor commands 

Block commands: 

»Amiga« or »Ctrl« + 

b - Mark block 

c - Copy block 

x - Cut block 

i - Insert block (same as »Fill block«) ^- 

f - Fill block (same as »lnsert bIock«) 

u - Unmark block 

t I - Lowercase block 

] H, - Uppercase block 

y - Rotate block 

k - Registers used 

w - Write block (for printing specify »PRT:«) ' 

Search, Replace: 

»Amiga« or »Ctrl« + 

S - Search start 

s - Search forward V. 

R - Replace start 

r - Replace forward 
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C 



Jump commands: 




»Amiga« or 
! 


»Ctrl« + 

- Mark 1 




@ 


- Mark 2 




# 


- Mark 3 




1 


- Jump 1 




2 


- Jump 2 




3 


- Jump 3 




J 


- Jump to mark »;;« 




i 


- Jump to line 




Move commands: 




»Shift« + 






up 


- Page up 




down 


- Page down 




left 


- Begin of line, 


BOLN 


right 


- End of line, 


EOLN . 


»Amiga« or 


»CTRL« + 




a 


- 100 lines up 




z 


- 100 lines down 




t 


- Top of file 




T 


- Bottom of file 




Mil + 

left 


- Word left, 


LWORD 


right 


- Word right, 


RWORD 
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Fast delete: 
»Ctrl« + 

Del - Delete to end of line 

Back - Delete to beginning of line 
»Amiga« or »Ctrl« + 

d - Delete line (remember) 

C 

Others: 

» Amiga « or »Ctrl« + 

m - Do macro 

M - Start macro creation (end macro creation) 

g - Grab word to diary buffer, (press cursor up 

in input line to get the word) 

DEL - Delete one char 

BACKSPC - Back delete one char 



If »Numl_ock« is selected you can use the numeric pad to 
move the cursor. . . 



C 
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Special help to some of the editor commands: 

»J« - Jump to mark »;;« 

Place a »;;« mark on one or more lines in your source file. 
Pressing »amiga-shift-j« will jump to the nearest following »;;« 
mark. You can use this to mark each new part of your pro- 
gram. 

»!«,»@«,»#« - Mark 1,2,3 

You can mark a special location in your source, it is not a 
physical mark, just a location stored within the assembler. So if 
you want to be able to jump fast to a specific routine, just 
mark the first char of this routine, and jump to the mark when 
you want. 

»M« - Start macro creation 

The macro definition works as a tape recorder, it records all 
key pressions. If you have to change the same thing in many 
lines, just record the key pressions for changing one line, and 
press » Amiga- m« to perform the same actions on all the 

others. 
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6 The Command Line 

The command line is the main area in this assembler. You 
can recognize the command line by the prompt: 



Command line instructions: 


Project: 




ZS 


- Zap source 





- Old source 


R 


- Read 


RR 


- Read binary 


RO 


- Read object 


W 


- Write 


WB 


- Write binary 


WO 


- Write object 


WL 


-Write link file 


1 


- Insert 


u 


- Update file 


ZF 


- Zap file 


Zl 


- Zap include memory 


WP 


- Write preferences 


=M 


- Add workspace memory 


! 


- Quit assembler 



c 



c 
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Editor: 

T [line] - Top of file/jump to line 

B - Bottom of file 

L [text] - Search for text 

ZL [lines] - Zap number of lines from cursor 

P [lines] - Print number of lines from cursor 



Memory: 






M 


[.size][addr] 


- Edit memory 


D 


[addr] 


- Disassemble 


H 


[.size][addr] 


- Hex dump 


N 


[addr] 


- ASGH dump 


@D 


[addr] 


- Disassemble line 


@A 


[addr] 


- Assemble line 



@H [.size][addr] - Hex dump line 

@N [addr] - ASCII dump line 

S [.size] - Search 

F [.size] -Fill 

C [.size] - Copy 

Q - Compare 

Insert: 

ID - Insert disassemble 

IH [.size] - Insert hex dump 
IN -Insert ASCII 
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Assemble: 

A - Assemble source in editor 

@A [addr] - Assemble to memory 



AO 




Assemble optimize 


AD 




Assemble debug 


=S 




■ Symbol table print ' \ 


— 


( 


Monitor: 






J 


[addr] 


- Jump to address 


G 


[addr] 


- Go to address 


K 


[steps] 


- Single step n steps 


X 


[register 


] - View/edit register values 


ZB 




- Zap breakpoint buffer 


Disk: 






RS 


[drive] 


- Read sector 


RT 


[drive] 


- Read track 


WS 


[drive] 


- Write sector 


WT 


[drive] 


- Write track 


cc 


[drive] 


- Calculate boot checksum 


Others: 






E 




- Load extern files 


V [path] 


- View directory 


> 




- Direct output (to PRT: or DFn: ...) 


? [- 


expr] 


- Calculate value 



c 



c. 
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Special help to the above commands: 



Project: 

ZS - Zap source 

Zaps the source, the copybuffer and the code. The source 
can be obtained again by typing »0« (Old), but only if you 
haven't entered the editor after zapping the source. 

O - Old source 

This command enables you to undo the »ZS« command 
(Zap Source). It can also sometimes be used to rescue the 
source after a crash, especially if you always allocate your 
workspace at the same absolute address. 

R - Read 

Reads a file into the editor. The file can be any kind of text 
file {you can even write an essay in the editor). Normally an 
extension ».S« (Source) is appended to the name, if you 
do not want this extension just delete it, or if you never 
want it disable the »Source.S« flag in the preference 
menu. This read file command will delete the file in the edi- 
tor. Use »l« (Insert) to add a new piece of source to the 
already existing source. 
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RB - Read binary 

This reads a binary file into a memory location. After having 
typed the file name you will be asked the following questi- 
ons. 

BEG> 
END> 

BEGin is the first location in memory where you want the 
file; END is the first location after the file: So 

beg>$70000 ,, .... ■. .. ... 

END>$71000 

will read the first »$1000 = 4096« bytes of the binary file 

into the memory starting at »$70000«. 

If you want the entire file loaded just ignore the »END>« 
question like this: 

BEG>$70000 . • ■ ■ 

END> 

The binary file will then be loaded in its full length. ,.: 



RO - Read object . 

Reads executable file (files like DIR, LIST, ASMONB etc.). 

The file will be put into a newly allocated memory location. 
The program will be relocated to begin at an absolute r 

'address. -This address will be returned to' -you. It is now in 
most cases possible to execute the program. {Note: com- 
mands like »dir«, »list« etc. are depending on information 
sent to it from the CLl, so you will have to simulate this 
information if you want to activate them, this can be a little 
hard.) 
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Because the file takes up memory, the memory used by 
. the last loaded object wili.be freed when loading a new ob- 
ject, Trying to load a object file called "" (no name) will free 
the memory without loading any new object. . 

W - Write 

Writes the file from the editor. This will save the file edited 
in the editor as a normal ASCII file. All normal. editors and 
word processors will be able to load this file so it is possible 
. for you to edit other files than sources in this editor. 

Normally an extension ».S« (Source) is appended to the 
name input line, if you do not want this extension just 
delete it, or if you never want it disable the »Source,S« flag 
in the preference menu. 



WB - Write binary 

Writes a raw file from any specified memory location to disk 
as a binary file. After having typed the file name you will be 
asked the following questions. 

BEG> 
END> 

»BEG« is the first location in memory where'you want the 
• file. »END« is the first location after the file. So •.,■■ 

BEG>$70000 '"' 

END>$7100(J ' l - ■" "- ■ . ' ,; 

will write the first $1000 = 4096 bytes,. from the memory 
starting at $70000 into the binary file. 
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WO - Write object 

If a source code is assembled, it is possible to save the 
code to the disk as a file that can be started from the CLI 
(also called a load file). If you want to write a linkable file 
use »WL« (Write link file) instead. 

I - Insert 

This command enables you to insert a new piece of source 
to the already existing source. The name of the already 
existing source will not be afflicted. See »R« (Read) for 
more detail. 

U - Update file 

Writes the file currently in the editor to the disk using the 
same name as when loaded. Works generally like »W« 
(Write). 

ZF -Zap file 

Zaps a file on the disk. 



Zl - Zap include memory 

When you use include files they are loaded into memory to C 

be assembled (read info under assembler directives). To 
speed things up a little these files are kept in memory 
instead of being loaded everytime you assemble. To free 
this memory when not using the files type »ZI«. 
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WP - Write preferences 

This function will create a file on the disk called »ASM- 
One.Pref«, this file contains the status of your flags in the 
preference menu. You can load this file into the editor, and 
it will look something like this.' 

-RS -L7 +NL+AA+RL+WB 

You can change the preference file to dp more than just 
setting the flags. You can change it to: 

-RS-L7+NL+AA+RL+WB\F\200\ 

This will automatically allocate 200 kb of fast memory. The 
»\« is »Return«. 

=M - Add workspace memory 

Let's say you have allocated 200 kb of memory but this is 
not sufficient. You can add any amount of memory to your 
workspace. But if it is not possible for the assembler to 
allocate the new area next to the existing area, you will 
have to restart the assembler to allocate the new memory. 
See »!« (Quit) for this action. 

! - Quit assembler 

When selecting this command, you can do two things. 
Quiting the assembler or restarting it. When restarting. it, 
any memory allocated will be freed, and your code will be 
lost. The assembler is like newly loaded. If you choose to 
quit the assembler any memory allocated by the assembler 
wili be freed. 
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Editor: 

T, -Top of file/jump to line ^ 

Jump "to the line number specified after »T«, if no number 
is given, then just jump to the top. Like this: ■ 

T100 ; Go to line 100 

T ; Go to top 

T-l " ; Go to last line 

B - Bottom of file 

Go to bottom of the file in the editor.' ' 

L - Look for text 

Search in the source for the text specified after »L«. 

Example: " 

LMOVE 

, • To continue searching for the same item: - ' . 

L 

ZL - Zap number of lines from cursor 

Zaps a number of lines specified after »ZL« from the last 
cursor position. Example: 

ZL100 ■ '' 

will zap 100 lines from the cursor position. 
ZL-1 

will zap all lines from the cursor position to the end of the 

source. 



C 



C 
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P - Print number of lines from cursor 

Prints a number of lines specified after »P« from -the last 
cursor position. To print these lines on -the printer, select 
»PrinterDump<< in the preference submenu (or press »ctrl + 
■ p«). Information on how to install the printer can be found 
in Appendix A. Example: - 

P100 

prints 100 lines from cursor position, 
p-i 

prints all lines from cursor position. ... 



Memory: 

M - Edit memory 

Inserts text or hex values at a specified memory location. 

D - Disassemble 

Enters the monitor disassemble function. This will give you 
an editor like view of the source where you can scroll up, 
down, jump etc. If you want to change a command just 
Q_ type it on the line where you want it- and press » Return* Mf 

you regret press »Esc« (seethe »Mon Funct.«menu). 
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H - Hex dump 

Enters the monitor hex dump function. This wili give you an 
editor like view of the memory with both, hex dump and 
ASCII dump. You can edit directly in the memory and scroll 
up and down with the cursor keys. If you want to change a 
longword like a vector use the »M.L« command instead. 
Because this will set the entire longword at once instead of 
one nibble at a time (see the »Mon Funct.« menu). 

N - ASCII dump 

Enters the monitor ASCII dump function. This will give you 
an editor like view of the memory with 64 chars ASCII 
dump. You will be able to enter a new text simple by pla- 
cing the cursor at the desired location and type your text as 
normal (see the »Mon Funct.« menu). 

@D - Disassemble 

Disassembles 12 lines of code from the address specified, 
if no address is given, then just continue from the last 
address. To use disassembled lines in your source see 
» Insert DisAssem«. 



@A - Assemble memory C 

Assembles commands to memory like from a good old 
c64'er monitor. 

@N - ASCII dump 

To use an ASCII dump in your source see "Insert Ascii«. 
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@H - Hex dump 

To use a hex dump in your source see » Insert hex dump«. 

S - Search 

The input sequence is as follows: 
>s 

BEG>$10000 
END>$20000 

After having specified the begin/end addresses you have 
to specify what data to search for, you can type: 

DATA>123 4321. L "HELLO" $5432. W %100-101.B 
Byte size is default. 

F - Fill 

Be careful, filling a wrong area will wipe out the entire 
Amiga system. 

C - Copy 

Copies any memory area to another location. Be careful 
like with the fill command. 

Q - Compare 

Compares two areas. If areas are not equal, the first non- 
equal memory location will be displayed. 
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Insert: 

ID - Insert disassemble 

This is a very powerful command, that enables you to di- 
sassemble the memory, and insert the disassembled area 
in your source code. The new code will be as far as it was 
possible supplied with labels. This enables you. to assemble 
the area like any other source code. ' ■■- Q 

IH - Insert hex dump 

This command lets you insert a memory area into your 
source code, as »DC« statements. ■ 

IN - Insert ASCII 

This command lets you insert a text area into your source 
as »DC.B« string statements. If a non-ASCII value occures 
its alternate hex value will be inserted instead. 
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Assemble: 

A - Assemble source in editor 

This is the normal assembler option, the same as on 
»Amiga-Shift~A«. ■'" 

@A - Assemble to memory 

See the »Memory« section. 



AO - Assemble optimize 

Assembles your source as normal, but optimize all 
branches to ».S« (short form). If the branch, is longer than - 
128 to 127 it will be forced to ».L« (long jump). 



AD - Assemble debug 

Assembles with the debug option on.. The source will also 
be assembled in this way if you activate the debugger. 



=S - Symbol table print 

After the source is assembled you might wish to view the 
global labels made. These can be outputted to. printer by 
activating the »PrinterDump« option. A symbol table will 
also be created when you choose the list file option. 
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Monitor: 

J - Jump to address 

This command jumps to the specified address like a 
subroutine jump (JSR). If no address is specified a jump wilt 
be made to the first address in your program. 

To jump to the label in your program called »START« type: 

>JSTART 

G - Go to address 

Like jump, except that only a breakpoint or an illegal 
command can stop this {like JMP). 

K - Single step n steps 

Steps n steps from the current position of the program 
counter. See the debugger description for an easier way to 
single step. 

X • View/edit register values 

This can be used in one of two ways: 

>X ; Show all registers 

>XD2 ; Edit D2 

If you just type »X« all registers are shown, including USP, 
SSP, SR and PC. The status register flags are also dis- 
played with letters. All changes since last time the registers 
were viewed will be highlighted {underlined when output to 
printer). 



C 



C 
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Disk: 



RS - Read sector 

Reads a sector into memory. A disk contains 80 tracks on 
both sides, each containing 11 sectors (80*2*11 = 1760 
sectors). Each sector consists of 512 bytes. The boot biock 
is two sectors long (1024 bytes), and starts at sector 0. The 
disk name is placed at sector 880 (on normal disks It is). 

If you want to read the 2 sectors long boot block from 
»df1:« into »$70000« type: 

>RS1 

RAM PTR>$70000 

DISK PTR>0 

LENGTH>2 

Warning: Data from direct disk access can only be loaded 
into chip memory. 

RT - Read track 

See »RS« for explanation. 

WS -Write sector 

See »RS« for explanation. 

WT -Write track 

See »RS« for explanation. 
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CC - Calculate boot checksum 

As mentioned under »RS«, the boot block is 1024 bytes 
long. The boot block is the first part of the disk the system 
loads into memory when you insert a disk in your "drive. It 
tells the system what kind of disk it is; (DOS onKIGKstart). 
The boot can also contain a program. To make sure -it is ok 
a checksum is applied. With »CC« you can recalculate the 
checksum on a disk. This is used if you,have written your 
own boot block to the* disk. '' ■< . -■=■. = :-■■ 

••i:To calculate the checksum on »df1:« type: ! - ■ .< ">■ . 

>cci 



Others: 

E - Load extern files ■■-.,'•,;.-■■ : 

Files marked in the source with an extern directive will be 
loaded when typing an »E«. To load only specific numbe- 
red extern files type 

E [number] 
For further information see the »>EXTERN« directive. 

V - View directory 

View directory from the path written after »V«. This was 
necessary to apply because if you have disabled the 
requester library this is the only way you can know what is 
present on the disk. You type like this: 

VDFO: 
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If you don't want to view the directory, but just want to 
. change the parent. directory, type: 

V DFO: 

If you want to view the last directory, and want to watch it 
sorted just type »V«. " ■' ■ - •" 

> - Direct output 

You use this command to direct the output to the printer 
(PRT:) or to a file. If send to a file, the file will carry the 
extension ».TXT«. This file is a standard text file and can 
be loaded into the editor. To end this special output type, 
enter an empty path. 

If you want to output the text written on the screen to the 
file »DIARY« type: 

» 

FILENAME>DIARY 

If you want to end the output just enter a blank file name. 
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? - Calculate value 

You can use all the common operators, and all the labels 
defined. The result will be written in hex, decimal, ASCII 
and binary. 

To calculate the sum to »123« and »321« type: 

>?123+321 

If you want to calculate the square of DO type 
>?D0*D0 C. 



c 
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7 The Assembler 

The assembler part is one of the fastest on the market. It as- 
sembles with a rate of 50000-70000 lines/minute on a stan- 
dard AMIGA. It is Macro Assembler compatible, this insures 
that old source codes can be fitted on this newer assembler, 
without big troubles. 

When a source code is ready in the editor, choose Assemble 
in the Assembler menu or press Amiga-Shift-A or type from 
the command line: 

>a 

to assemble the source code. If an error occurs, the iine num- 
ber plus the content of the line will be printed and an error 
message will guide you to correct the error. 

If you want to break assembling, press »Ctrl-C«. 

You can choose the way of how to assemble the code. The 
following options can be choosen: . 

1 - List File 

2 - Pageing 

3 - Halt Page 

4 - All Errors 

5 - Debug 

6 - Label: 

7 - UCase = LCase 
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How these flags work: 

1. If you set this flag, a list file will be printed. Flag »2« and 
»3« selects the way of how to output this list file. 

2. See flag 1 

3. See flag 1 

4. If set, the assembler will assemble the entire source code 
without stopping after each error. It will print the line and 

. the error text, but will continue. (You can output this to the 
printer by choosing the »PrinterDump« option (»Ctrl+p«). 

5. This flag selects the debug assemble option. This option 
takes up extra memory, but if you use the debugger often, 
you can enter the debugger without reassembling the 
source. 

6. If set, all labels must end with a colon »:«. The advantage 
is that commands can be placed on the first column. 
Some old assemblers use this system, so if you used an 
assembler like that before ASM-ONE, the flag is to set. 

7. Normally set. But if cleared two names spelled in the 
same way, is not the same name if they use different 
caseing. 

When the program is finished and assembled, an executable 
file can be created with the »WO - Write Object« command 
from the Command Line or menu. (If you have used »XREF« 
or »XDEF« and want to link the program together with other 
programs, just save the file using »WL - Write linkfile«. 



C 
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7.1 Programs 

Each line in your source code can be one of the following 
types: 

1 - Blank line or comment 

2 - Statement 

3 - Assembler directive 

Some examples of comments: 
(1). A line beginning with »*« is a comment line 
* This is my program 

(2). A »;« placed anywhere on a line tells that the rest of the 
line is a comment. 

subq.l #l,dO ; rest = rest - "1 ' 

cmp.l dl,dO ; equal ? 

(3). A text string following any complete instruction or 
directive is a comment. 

moveq #0,dQ ; zero counter 

(4). A blank line 

In genera! a line (statement) has the following layout in BNF 
notation: 

[<label>] <bpcode> [<bperand>[,<cperan<£>-]. . .] [<conment>] 

As you can see, a statement is seperated in fields.-, 



label 


opcode 


operands 


comment 



The fields must be separated with one or more spaces/tabs. 
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7.1.1 Label field 

A label is a user defined symbol, and is characterized by: 

1. Starting at the first column 

2. Starting at any column and ended with a »:« 

Labels are assigned to the value and type of the program 
counter, the address of the first byte in the following instruc- 
tion. Labels with the same name may not occur twice. The 
assembler will report the error message: 

** Double Symbol 

Local labels: 

A local label is like a normal label, but only known in one part 
of the program. In that way you can use the same name more 
than once in a program. You define a local label like a normal 
label but add a period as the first letter like this: 

. labell 

A local label may only be referenced between two normal glo- 
bal labels. An examble can show how: 



C 



label 



opcode operands 



clear moveq 
moveq 
lea 

. loop move . 1 
dbf 

end rts 



#0,d0 
#100-1, dO 
memory, aO 
dO, (a0)+ 
dl, .loop 



comment 



mem to clear 



C 



In this simple example ».loop« is only known between »clear« 
and »end«. We can now use the label ».loop« in other places 
in the source. 
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7.1.2 Opcode Field 

The opcode may not be placed in the first column (it is only 
possible to place the opcode in the first column if the flag 
called »l_abei:« is set). It can only follow a space/tab or a label 
followed by space/tab. A opcode can be a pre-defined or user- 
defined symbol. Specified with: 

1) A Motorola MC68000 opcode, mentioned later. 

Q 2) Assembler directive 

3) Macro statement 

A size specifier may follow an opcode. A size specifier is one 

of the following: 

,B - Byte size 

.W - Word size 

.W - branch Word size (also ».L« branch long) 

.B - branch Byte size (also ».S« branch short) 

The size must match with the current opcode specification. 

7.1.3 Operand Field 

A operand can consist of one or more operands. Each ope- 
rand must be separated from the opcode with one or more 
spaces/tabs, and each operand is separated by a »,« followed 
by one or more spaces/tabs. The optional spaces after the 
comma are an extension the motorola standard included, 
because it often is convenient with the operands placed in 
coiumns. 

7.1.4 Comments 

After a correctly ended command followed by at least one 
space or tab, anything else is treated as a comment. 
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7.1.5 Expressions 

An expression is a combination of algebraic operators, ope- 
rands, constants and parentheses. It may have a constant-, 
relative- or a truth-value.. »True« is assigned the value »-1«, 
»fa!se« the value »0«. 



Operators: 

ASM-ONE has the following operators: 

1. Monadic minus, logical not -, ~ 

2. Left/Right shift, Power «, », A 

3. Logical AND, OR, EOR &, !, ~ 

4. Multiply, Divide *, / 

5. Add, Sub +, - 

6. Compare >, >=, =, <=, <, <> 

When evaluating an expression, the operators are evaluated 
according to their priority. In the above list the lowest number 
is evaluated first. 

To change this precedence, parentheses can be included. 
Both square and normal brackets can be used. 

[1+2] *3 = 9 or (1+2) *3 - 9] 

but C 

1+2*3 = 7 
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Operands (Symbols): 

A symbol is a string of up to 100 characters, each character 
can be one of the four given below but the first character can 
only be one of the first three 

1. Alphabetic character ['A'./Z'] or ['a'./z']. Distinction 
between lower- and UPPERcase is optional. 

2. Underscore '_' 

3. Period '.' 

4. Alphanumeric character ['0'..'9'] 

Notice that .all symbols starting with a period are treated as a 
local symbol {see » local labels«). , ... 

A symbol can be defined in one of the following ways: 

Absolute value: 

EQU - The symbol was EQUated to an absolute value 

SET - The symbol was SET to an absolute value 

RS - Define a structure of offsets 

OFFSET - Define labels as offsets 

<label> - The symbol was used as a label in an absolute 
program {a program using »ORG« is absolute). 

Relativ value: 

EQU - The symbol was EQUated to a relativ value 

SET - The symbol was SET to a relativ value 

<label> - The symbol was used as a label 
Register: 

EQUR - The symbol was EQUated to a Register. 

REG - The symbol was equated to a REGister list. 
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Numbers: 

A number can be used in a expression, like any other con- 
stant symbol. There are five different number types; 

1. Decimal 1234,-234 

2. Hex $fab, -$fc 

3. Octal @176 

4. Binary %1 001 001 

5. ASCII 'abed', "abed", abed' L 

With ASCII-strings containing less than four characters, the 
character values are justified to the right. To use quotes in a 
ASCII string, do like this: 

Quote '- ' = "'" or " ■ 

Quote " = "" or 

Quote " = "*" or 



C 
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7.2 Directives 

The directives are not code-producing statements, but instruc- 
tions to the assembler on how to create the code. Exceptions 
are »DC« and »DCB«. 

The directives are: 

Assembly control: 



| SECTION 


Program section 


I RORG 


Relocatable origin 


JORG 


Origin (absolute) 


[load 


Load address (absolute) 


j OFFSET 


Define offsets 


1 ENDOFF 


End offset 


[ END 


End program 


| BASEREG 


Set base register 


Data defini 


Hon: 


[DC 


Define constant 


Idcb 


Define constant block 


[ DS 


Define storage 


1 BLK 


Block (see »DCB«) 


[ DR 


Define relativ value 
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Symbol definition: 



EQU 


Assign permanent value 


SET 


Assign temporary value 


EQUR 


Assign register name 


REG 


Assign register list 


RS 


Assign relativ value 


RSRESET 


Zero relativ value 


RSSET 


Set relativ value 


Macro directives: 


MACRO 


Start macro definition | 


NARG 


Special symbol 


ENDM 


End of macro definition 


1 MEXIT 


Macro exit 


| CMEXIT 


Conditional macro exit 


|rept 


Repeat code start 


| ENDR 


End repeat area 



o 



o 
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Conditional assembly: 






CNOP 


Conditional »NOP« for alignment 






EVEN 


Force address »EVEN« 






ODD 


Force address »ODD« 






IFEQ 


Assemble if expression -zero 






IFNE 


Assemble if expression <> zero 






IFGT 


Assemble if expression > zero 




1FGE 


Assemble if expression >= zero 




IFLT 


Assemble if expression < zero 




IFLE 


Assemble if expression <= zero 






IF 


Assemble if expression true 






[FC 


Assemble if strings are identical 




IFNC 


Assemble if strings are not identical 




IFD 


Assemble if defined 




IFND 


Assemble if not defined 




1FB 


Assemble if blank 




IFNB 


Assemble if not blank 






IF1 


Assemble if PassL. 






IF2 


Assemble if Pass2„ 






ELSE 


Efse do this if last was false 






ENDC 


End conditional assembly 
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Listing control: 



PAGE 


New page in list file 


NOPAGE 


Turn off pageing 


LIST 


Turn on listing 


NOLIST(NOL). 


Turn off listing 


LLEN 


Set line length 


PLEN 


Set page length 


SPC 


Skip n blank lines . 


TTL 


Set program title 


FAIL 


Generate an assembly error 


MASK2 


No action 


PRINTT 


monitor output string 


PRINTV 


monitor output value 



c 



External Symbols: 


1 XDEF 


j External definition 


JXREF 


| External reference 


[entry 


"j See XDEF 


| EXTR'N 


| See XREF 


| GLOBAL 


| See XDEF 



c 
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General Directives: 


JUMPPTR 


Jump start address pointer 


INCBIN 


include binary file. 


[MAGE 


See INCBIN 


INCLUDE 


Include a source file 


INCDIR . 


Set include directory path , 


>EXTERN 


Load a data file 


IDNT 


Name program unit 


AUTO 


Automatic line command 



c 
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7.2.1 Assembly Control Directives 

SECTION Program section 
Syntax: [<label>] ' SECTION <name>[,<type>] 

This directive Creates a new section called <name>, with the 
program counter starting at zero. Or, if <name> is already defi- 
ned, restores the program counter to the last address in this 
section. 



C 



<name> is a string optional enclosed in double qoutes, 
<type> if included is one of the following: 

CODE create a section containing relocatable code 
DATA create a section containing initialized data 
BSS create a section containing uninitialized data 

To force the code to be placed either in fast, chip or public 
memory, the above types can be extended with the following: 

DATA_P place data in public memory (same as »DATA«) 
DATA_C place data in chip memory 
DATA_F place data in fast memory 

The same extensions can be used on »CODE« and »BSS«. 
Specifying »fastmem« can be a dangerous thing to do, use 
this statement only if it is absolutely neccessary for your pro- 
gram to run in »fastmem«. 

Areas carrying the extension »_F« or »_C« will be »Auto- (^ 

Allocated« when assembling. If you don't want the area expli- 
citly put in chipmemory while assembling, deselect the 
»AutoAlloc« option in the preference menu. 

You can create up to 255 sections. The assembler starts with 
a code section carrying the name »TEXT«. 

<labei> will be assigned with the address of this new section. 
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RORG Set Relativ Origin 

Syntax: [<label>] RORG <absexp> 

This directive changes the program counter to be <absexp> 
bytes from the start of the current section. <absexp> can not 
be smaller than the current program counter. 

The <labe!> will be assigned with the value of the new pro- 
gram counter. 

ORG Set absolute Origin 

Syntax: [<labei>] ORG <absexp> 

This directive changes the program counter to the absolute 
value <absexp>. 

Warning: The Amiga is a multitasking system, where every- 
thing except »address $4« theoretically can be changed and 
put at any address, so using this directive must be done very 
carefully, and on own risk. 

The advantage is that you know exactly on wich address your 
code and data is placed. Many hardware orientated game or 
demo programmers use this directive. 

LOAD Set absolute memory load address 

Syntax: [<iabe!>] LOAD <absexp> 

This directive changes the output address of the assembled 
code to the address <absexp>. This enables you to assemble 
a program to one absolute address, and store it into another. 

For further details see »ORG«. 



63 



ASM-ONE 



OFFSET Define offsets 
Syntax: [<labe!>] OFFSET <absexp> 

The »OFFSET« directive starts an offset definition block that 
has the following layout: 



start 


OFFSET 


100 


datO 


ds.b 


1 


datl 


ds.b 

ENDOFF 


9 



The <label> »start« will be assigned to the start address of this 
offset definition: »D0 = <absexp> - 100« and »d1 = do + 1«. 
In offsets you can create both »code« and »data«. The data 
area is allocated in the current section, in your source code 
you can use the above offset like this: 



C 





LEA 


start, a4 




MOVE.B 


datO(a4),dO 




LEA 


datl(a4),a0 


. loop 


CLR.B 


(a0) + 




DBF 


DO, .loop 



Making data-addressing is faster and shorter and takes up two 
less bytes in the code, and four less bytes in the relocation 
table. 

To terminate an offset definition use one of the following direc- 
tives: 

ENDOFF 
SECTION 
OFFSET 
END 



o 
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ENDOFF End offset definition 
Syntax: [<label>] ENDOFF 

See »OFFSET« 

END End program 
Syntax: [<labei>] END 

Q Marks the end of your source code. If nothing follows the 

»END« directive it is not needed, the assembler normally as- 
sembles all lines. 

BASEREG Set Base Register 
Syntax: [<label>] BASEREG <label>,An 

Defines a register as a »base register*. This affects the fol- 
lowing two addressing modes: 

nn(An) and nn(An,Rn.s) 

Normally »nn« has to be a written as a positive or negative in- 
teger. But if »An« was defined as a base register, the offset 
»nn« would be treated as an offset from this address: 

LEA DataArea , A4 

MOVE . W DO , DataWord-DataArea (A4) 

DataArea: dcb.b 100 
DataWord: dew 
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This is the normal procedure if you want to access the location 
»DataWord«. Now this can be written in the following way: 

BASEREG DataArea,A4 
LEA DataArea,A4 
MOVE . W DO , DataWord ( A4 ) 

DataArea: dcb.b 100 
DataWord: dew 

In this way it is ; much easier to use an address register as an r 

global pointer, tq : a data. area. All address registers can be 

used to point at different areas, but they can not be redefined 

to point to more than one base in each source. 

Normally you would use a »BSS« hunk to store your data, 

and this way gives you a shorter and faster possibility to do 

this ( »A4« is normally used by the-C-Compiler as a global 

data area pointer).. 



C 



66 



The Assembler 



C 



C 



7.2.2 Data definition 

DC Define constant '-■-'■' - ■"'■■'' 

Syntax: [<Iabel>] ' DC[.size] <exp>[ ) <exp>E..'.3] 

This directive starts a constant definition, it can be followed 
by one or more numbers, and these numbers will be put into 
memory. 

Valid sizes are: 

,B - Byte ■'■■:..'■ . ■■■■:.' 

.W -Word (word size 1 Is default) ' 

.L - Long 

When the byte-size is specified, strings can be directly written 
without terminating commas, like this: 

DC.B 'hello how are you' 

With any other size, strings are right-aligned to the chosen 
size. '■■?.*' ! "■■ . ■ ■'■■..:■.■.-.■ 

Using »Word« or »'Long« on an odd boundary, will cause a 
warning, but the address will be word-aligned, and the <label> 
will get the new value. To avoid the warning, use the »EVEN« 
directive to word align the address. 
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DCB Define constant block 
Syntax: [<label>] DCB[.size] <absexp>,<exp> 

The »DCB« directive lets you define a block that is <absexp> 
elements long. One element has the specified size and con- 
tains the value <exp>. 

Valid sizes are: 

.B - Byte 

.W - Word (word size is default) Q ) 

.L - Long 

Using »Word« or »Long« on an odd boundary will cause a 
warning, but the address will be word-aligned, and the <label> 
will get the new value. To avoid the warning, use the »EVEN« 
directive to word-align the address. 

DS Define storage 
Syntax: [<label>] DS[.size] <absexp> 

The »DS« directive lets you define an uninitialized block that 
is <absexp> elements long. One element has the specified 
size. Valid sizes are: 

.B - Byte 

.W - Word (word size is default) 

■L - Long Q ) 

Using »Word« or »Long« on an odd boundary will cause a 
warning, but the address will be word-aligned, and the <label> 
will get the new value. To avoid the warning, use the »EVEN« 
directive to word align the address. 
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BLK Block 
Syntax: [<label>] BLK[.sizej <absexp>,<exp> 

This directive has been included to keep up compatibility with 
a few non-standard assemblers. If you are writing new pro- 
grams you should use »DCB« instead. 

DR Define relativ value 
Q Syntax: [<label>] DR[.size] <exp> 

The »DR« directive lets you define a relative value. The 
value put into memory will be: 
<exp>-* (* = current address) 

The size of this value will be checked as a signed size. An 
example of how it can be used is shown below: 

JUMP 



LEA 


DATA{PC),A0 




ADD.W 


DO, DO 




ADD.W 


DO,A0 




ADD.W 


(AO) ,A0 




JMP 


(AO) 




DR.W 


ROUTINE_PRINT 


; dO = 


DR.W 


ROUTINE CLEAR 


; dO = 1 



DATA 



The jump routine will jump to routine number put in »d0«. 
Valid sizes are: 

( -B -Byte 

.W - Word (word size is default) 
.L - Long 

Using »Word« or »Long« on an odd boundary will cause a 
warning, but the address will be word-aiigned, and the <labet> 
will get the new value. To avoid the warning, use the EVEN 
directive to word-align the address. 
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7.2.3 Symbol definition 

EQU Assign permanent value .. 
- Syntax: . <!abel> EQU <exp> 

This directive assigns the value <exp> to <label>. <label> 
can now be used as a constant value in other expressions. 

This statement is the same as the »=« statement. 

SET Assign temporary. value 
Syntax: <label> SET <exp> 

This directive assigns, the value <exp> to <label>. <label> 
can now be used as a value in other expressions or be 
assigned to a new temporary value. 

Note: You should never use forward references to a »SET« 
symbol. 

EQUR , . Assign register name 
Syntax: <label> EQUR <Rn> 

This directive can be used to attach a register to a <label>. 
You can use this if you are coding critical areas of your code 
where you are using many registers. 

Eg. BitPlanel EQUR A3 

MOVE.L DO, (BitPlanel) + 

The name »BjtPlane1« can not be redefined, but it is possible 
to attach many names to one register. 

NOTE: Oniy data and address register names can be used. 
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REG Assign register list '.'•■■ 

Syntax: <label> REG <List> 

This directive is used like ithe »EQUR« directive, but to this 
register you can attach a list of registers known from the 
»MOVEM« command. 

Eg. AllRegs REG . , D0-A6 

MOVEM.L AllRegs, - (A7) 

The name »AIIRegs« can not be redefined, but it is possible to : 
attach many names to the same register list. 

NOTE: Only data and address register names can be used. ■ 

RS Assign relativ value 
Syntax: [<label>] RS.[size] <absexp> 

The »RS« directive assigns the <label> to the current value 
of »RS«. After the value <absexp> in bytes is added to »RS«. 
To zero »RS« use the »RSRESET« directive. 

This directive gives a fast and easy way to define data offsets. 

How some library offsets could be defined with this directive: 



Start value 





RSRESET 






RS.B 


-30 


Open 


RS.B 


-6 


Close 


RS.B 


-6 


Read 


RS.B 


-6 


Write 


RS.B 


-6 


Input 


RS.B 


-6 


Output 


RS.B 


-6 
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RS RESET Zero reiativ value 
Syntax: [<label>] RSRESET 

See the »RS« directive for explanation. 

RSSET Set reiativ value 

Syntax: [<label>] RSSET <absexp> 

Instead of clearing, the »RS« value is set to a start value. (~ 

This is equivalent to writing: 

RSRESET 

RS . B <AbsWert> 

See the »RS« directive for explanation. . 



C 
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7.2.4 Macro directives 

MACRO Start macro definition 
Syntax: <Iabel> MACRO 

Start a macro definition. The <label> will become the name 
of this macro. To end a macro definition use the »ENDM« 
directive. 

A macro is used to assign a name to one or more lines of 
code. Each time the name is used as a operator the code will 
be filled in. It is possible to specify operands with each macro. 
To refer to each operand in the macro definition you use the 
backslash »\« followed by a number from 1-9. A backslash 
followed by »@« produces the following symbol: 

\@ — __nnnn 

where »nnnn« is the number of times a macro is used. 
An example of a simple macro: 

CoordsXYZ MACRO 

DC.W \1,\2,\3 

ENDM 

In your program you can write: 

CoordsXYZ 10,10,10 
CoordsXYZ 10,-10,10 

CoordsXYZ -10,10,10 
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If suddenly the coordinates have to .be scaled by a factor of 
1 6 you just rewrite the macro to: 

CoordsXYZ MACRO 

DC.W \l*16,\2*16A3*i6 

ENDM 

You can not define a macro in a macro, but you can refer to 
other macros within a macro, you can even refer to it self. To 
terminate macros like this use »MEXIT« or »CMEXIT«.' The 
limit to the level of nesting macros is currently set to 25i (^ 

NARG Special symbol 

Syntax: NARG 

This special symbol is assigned to the. number of arguments 
passed to the current macro. Outside a macro »NARG« car- 
ries the value »0«. 

ENDM End macro definition • 

Syntax: ENDM 

End a macro definition. See also »MACRO«, »MEXIT« and 
»CMEXIT«. 



MEXIT Macro exit 

Syntax: MEXIT 

Exit a macro definition. When the assembler reaches this 
statement, the macro is terminated, even if the end wasn't 
reached. 



C 
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CMEXIT Conditional macro exit 
Syntax: CMEXIT <absexp> 

Exit a macro definition if current level of the macro is 

<absexp>. If this. level is reached the macro is terminated, 
even if the end wasn't reached. 

REPT Repeat code start 

Syntax: REPT <absexp> 

Start repetitive block assemble. You use this to repeat one 
or more commands a given number of times. The block is 
ended with the »ENDR« directive, - 

Let's say you want to move 10 bytes very fast, you could do 
like this: ■ 

REPT 10 

MOVE.B (A0)+, (Al) + 

ENDR 

ENDR End repeat area 

Syntax: ENDR 

End the repetitive block assemble. See »REPT« for the use 
of repeative blocks. 
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7.2.5 Conditional assembly 

CNOP Conditional NOP for alignment 

Syntax: [<label>] CNOP <absexp1>,<absexp2> 

This directive aligns the address to <absexp2> and adds 
<absexp1> to this new address. 

CNOP 0,4 fi 

Aligns to a tongword boundary. 

CNOP 2,4 

Aligns to a longword boundary plus 2. 

The <Iabel> will be assigned to the new value of the program 
counter after »CNOP«. 

NOTE: »CNOP« does no initializing. 

EVEN Force address to even 

Syntax: [<Iabel>] EVEN 

This statement has the same effect as: 

CNOP 0,2 

The <!abel> will be assigned to the new value of the program f 

counter after »EVEN«. 

NOTE: »EVEN« does no initializing. 
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ODD Force address to odd 
Syntax: [<label>] , ODD 

Force address to »odd«. This can be replaced by: 

CNOP 1,2 

but »ODD« will NOT change an already odd program counter. 
The <label> will be assigned to the new value of the 



programcounter after »ODD«. 
NOTE: »ODD« does no initialisation. 



IFEQ 


Assemble if expression 


= 


zero 


IFNE 


Assemble if expression 


<> 


zero 


IFGT 


Assemble if expression 


> 


zero 


1FGE 


Assemble if expression 


>= 


zero 


IFLT 


Assemble if expression 


< 


zero 


IFLE 


Assemble if expression 


<= 


zero 



The above commands can be replaced by the more genera! 

IF Assemble if expression true 
Syntax: IF <boolean> 

A »boolean« consists of two expressions divided by one of the 
following: 

= 3 >, <, >=, <=, <> 

If the »IFxx« statement was false, the code will be skipped 
until an »ENDC« or an »ELSE« statement is reached. 

»IFxx« statements can be nested up to a.level of 25. 
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IFC Assemble if strings are identical 
Syntax: IFC <string>,<string> 

See the general » I F« command for information on; how »IF« 
statements are treated. 

IFNC Assemble if strings are NOT identical 
Syntax: IFNC <string>,<string> ..-,■■:, r 

See the general »IF« command for information on' how »IF« 
statements are treated. 

IFD Assemble if defined , 
Syntax: IFD <exp> . ., ■ = 

See the general » I F« command for information on how »IF« 
statements are treated. ;■■■■' 

IFND. Assemble if NOT defined:. :■ :' 

Syntax: IFND <exp> 



See the general »IF« command for information on how »IF« 
statements are treated. ' ■ ' ' '•'■ 

IFB Assemble if blank 
Syntax: IFB <symbol> ■■■■■.••■ ■■- - 

This instructions tests the <symboii>, if any symbol supplied, 
wether the symbol is not blank: You use this to check if a 

macro statement is supplied or not.- ■ • , " 1 ' 
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IFNB Assemble if not blank 
Syntax: IFNB <symbol> 

This instructions tests the <symbol>, if any symbol supplied, 
wether the symbol is not blank. You use this to check if a 
macro statement is supplied or not. 

IF1 Assemble if PassL. 

Syntax: IF1 ■.:■■■.. 

If Pass 1 the following block is assembled. 
IF2 Assemble if Pass2.. 
Syntax: IF2 

If Pass 2 the following block is assembled. 

See the general »IF« command for information on how »IF« 
statements are treated. 

ELSE Else do this if last was false ' ■'.. 

Syntax: ELSE 

See the general »IF« command for information on how »IF« 
statements are treated. 

ENDC End conditional assembly ... 

Syntax: ENDC 

See the general »IF« command for information on how »IF« 
statements are treated. 
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7.2.6 Listing control 

PAGE New page in list file 

Syntax: PAGE 

Insert a new page in the list file and begin paging. 

NOPAGE Turn off paging Q 

Syntax: NOPAGE 

LIST Turn on listing 
Syntax: LIST 

Start creation of the list file. 

NOLIST Turn off listing 
Syntax: NOLIST (or NOL) 

End creation of the list file. 



LLEN Set line length 

Syntax: LLEN <absexp> 

Set line length between 60 and 132 



C 
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PLEN Set page length 

Syntax; PLEN <absexp> 

Set page length between 20 and 100 

SPC Skip n blank lines 
Syntax: SPC <absexp> 

Send n blank lines to the list file. 

TTL Set program title 
Syntax: TTL <string> 

Set the program title. The title is used as the list file title. 
To give a name to a program unit see »IDNT«. 

FAIL Generate an assembly error 
Syntax: FAIL 

Generate an assembly error. This error wiil appear in the list 
file. 
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PRINTT Print a text string to the screen 

Syntax: PRINTT <string>[,<string>,..] 

Print a text string to the screen while assembling. You can use 
this directive to print needed information or instructions to 
others when they assemble your source, or use it as a remin- 
der for yourself, like this: 

PRINTT "This line was assembled" 

PRINTV Print a value to the screen 

Syntax: PRINTV <expr>[,<expr>,..] 

Print a value to the screen while assembling. You can use this 
directive to print useful information, to check that everything is 
done correctly while assembling. This directive is especially 
useful if you use conditional assembling or »REPT« sta- 
tements. 

PRINTV ScreenAddress, ScreenWidth 
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7.2.7 External symbols 

XDEF External definition 

Syntax: XDEF <iabel>[,<labe!>..] 

Defines a name as external. Each <label> may be referen- 
ced from other modules even from high language modules. 

See »XREF« for an example of how to use this directive. 

V. NOTE: Code using »XDEF« or »XREF« can not directly be 

executed. 

XREF External reference 

Syntax: XREF <label>[,<tabel>..] 

Reference to other external definitions in other modules. Each 
<label> may. now be handled as a normal relative symbol. 

An example of how to use this directive is given below. 
Assemble and save Program 1: 

XDEF ClearScreen 
ClearScreen 

CLR.L Screen 

RTS 
Screen DC . L 

Q_ Now assemble and save Program 2: 

XREF ClearScreen 

GoClear JMP ClearScreen 

You now got to files. Use a linker to link these two files into 

one executable file. 

NOTE: Code using »XDEF« or »XREF« cannot directly be 
executed. 
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7.2.8 General directives 

JUMPPTR Jump Start Address Pointer 
Syntax: J UMPPTR <labe!> 

This directive sets the start address for you program when 
you want to debug it. Normally the start address is set to the 
point at the first instruction in the first nonempty section. r~ 

This is address is also the address the assembler will jump to 
when you issue the command line instruction »J« or »G« 
without an address. 

INCBIN Include binary file 

.Syntax: INCBIN <string>[,<absexp>] 

Include binary data in your program. This data will be loaded 
every time you assemble. 

An example can be given: 

START: 

INCBIN "datafile" 

END: 

If »datafile« is a binary file of the length 1000 bytes, the label 

»END« will carry a value 1000 greater than »START«, and the (_ 

»datafile« will be loaded at the address »START«. 
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INCLUDE Include a source file 
Syntax: INCLUDE <string> 

Include a source file in your own source. Include files nor- 
mally contain constant definitions like library offsets and so on 
but they can actually contain any type of code. 

Create a normal source code containing all your definitions 
(constants, macros etc.). 

Include it at top of your program and now you can use all the 
definitions in the code as if you had actually written them at 
the top of your source. 

Here is how you write: 

INCDIR DFO: INCLUDE \ ; Where to get 

; the files 

INCLUDE exec/exec. i ; What file 

; to include 

You can have multiple includes following each others. Include 
files may also include other files (Up to a maximum level of 5). 

To speed things up a little, loaded include files are kept in 
memory. This prevents that they have to be loaded every time 
you assemble. 

To delete unused include files issue the command »ZI« - Zap 
Include Memory. 

INCDIR Set include directory path 

Syntax: INCDIR <string> 

Set the path of where to find the include files. Default is 
INCDIR "Df : Includes/" 
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>EXTERN Load a data file 
Syntax: >EXTERN [<num>,]<string>,<loadpos>[,<]ength>] 

Define a reference to an extern file with the name <string>. 
The file will be loaded at the address <loadpos>, if <length> is 

applied this will be the length of the file loaded. 

The »EXTERN« files is loaded when the line command 'E' is 
issued. If <num> is supplied, you choose only to load the ex- 
tern files carrying the same number. This is done by issuing r 
the line command E<num>. 

IDNT Name Program unit 

Syntax: IDNT <string> 

A program unit containing multiple sections must have a 
name. Normally this name is set to zero, but with IDNT you 
can assign a name to the. program unit. 

AUTO Automatic line command 

Syntax: AUTO <cmd>[\<cmd>..] 

Auto lets you issue one or more command line commands. 

AUTO E\ 



if you want all the extern files to be loaded automatically, 
every time you assemble. 

Here backslash means <return>. 



C 
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8 The Debugger 

This debugger is both a source-level debugger and a normal 
debugger. This means that you can run your own source 
directly, as if you where running the text file directly. You see 
your own source exactly as in the editor, with comments, line 
numbers etc. But at the same time you can watch all registers 
and memory locations etc. if you are debugging a program 
where you haven't got the source you can single step in a 
normal disassembly window. All the commands from the 
source level debugger are still available. You can even shift 
directly between the two viewing modes while debugging the 
same program. 

In the debugger you can use all the functions listed in the 
»Debug Funct«-menu. The functions are as listed: 

Step One 

One single step forward using a breakpoint. This is used to 
trace the main routine. Subroutines will not be traced, they will 
be skipped in one step. If you wish to enter a subroutine 
called from the main routine see the command <enter>. 

Conditional branched »Bcc«, »DBcc« and return from subrou- 
tine »RTS« are single stepped using trace mode. This means 
C that you dont have to enter these to follow where they go. 

»BRA« is also handled as a conditional branch. 

A »JMP« command is handled specially, it is also taken in one 
step, but the return address is copied from the stack and used 
as a breakpoint. This can cause a problem, because if you 
have pushed data onto the stack before issuing the »JMP« 
command (here I mean data used by the »JMP« routine), the 



87 



ASM-ONE 



last longword on the stack is not the return address. To trace 
this set a breakpoint yourself or use the command <enter>. 

Enter 

This command is used to enter a subroutine that would 
otherwise be taken in one big step. Here we talk about one of 
the following commands: »BSR«, »JSR« or »JMP«. If you are 
running in the »ShowSource« mode (this is the default way, 
where you see the source text while stepping) it is not ad- 
visable to enter a library call, because the address would not 
be found in your source. 

If this happens anyway, you can set a breakpoint and run the 
rest of the library routine in one bit or you can disable the 
»ShowSource« mode and single step the rest of the library 
routine by watching the disassembled version of it. Please no- 
tice that it is impossible to set a breakpoint in a ROM (Read 
Only Memory), so you will have to use the <enter> command 
all the time. 

Step n 

This enables you to run »n« commands in one step. This can 
be a little chaotic because it can be hard to see where you will 
end in 143 steps. The advisable way is to set a breakpoint. 

Editregs 

You can while you are tracing your program edit or change 
the contents of any register. This will of course change the 
result of your routine, but in some cases it is convenient just to 
change a wrong value instead of correcting the bug at once, 
being forced to reassemble the program. 



C 
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AddWatch 

Watch a memory location. Both direct addresses, registers 
and location names can be used. So the following are legal 
watch locations. 

BUFFER A0+D0+10 
BUFFER+2+D1 etc . 

The location can point to one of the following types of data: 

ASCII, String, Hex, Decimal, Binary, Pointer. 

If the pointer type is specified, it can be a pointer of one of the 
following types: 

del ; Absolute long (32 bits) 

dew ; Absolute word (16 bits) 

dr.l ; PC relative long (32 bits) 

dr.w ; PC relative word (16 bits) 

This pointer can point to all these types except a new pointer. 

DelWatch 

Each time you »addwatch« on a new element, this element 
name will be stored in the »DelWatch« menu. It is possible to 
remove one element from the watch list by selecting the 
desired element in the menu. 

ZapWatch 

This works like » DelWatch «, but it is just more efficient be- 
cause it deletes all watched locations from the watch list. 

JumpAddr 

Jump to a absolute address, that you are asked to type at 
the menubar. The absolute address can be a label, a register 
value etc. You can even jump to AO+4, A0+D0+2 etc. 
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JumpMark 

Your current line will be highlighted. Now move this line up or 
down with the cursor keys. Press <return> if you want to jump 
to the highlighted line, or press <esc> if you regret. 

B.P. Addr 

Set a breakpoint at an absolute address, that you will be as- 
ked to type in the menu bar. 

B.P. Mark 

Your current line will be highlighted. Now move this line up or 
down with the cursor keys. Press <return>if you want to set a 
breakpoint at the location of the highlighted line, or press 
<esc> if you regred. 

Zap B.P. 

It is possible to set 16 breakpoints. Each time the program is 
stopped, the breakpoint(s) at the break location will be remo- 
ved. If you want to remove (Zap) all breakpoints use this 
command. 

Additional flags: 

DisAssem - If selected, a disassembled version of the line 

you are placed at will be shown, (only of -_ 

interest when debugging a source file). \^. 

ShowSource - if set, the source will be shown. 

To see a little example of how the debugger works, you can 
load the program »BinaryConv.S« from the » examples* direc- 
tory. 
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9 The Monitor 

The monitor is not used to run programs but to examine the 
contents of different memory locations. It functions nearly like 
an editor. You can scroll up - down and change the contents 
of the memory as desired. 

Memory can be viewed in the following ways: 

{^_ 1. DisAssemble 

2. Hex Dump 

3. ASCII Dump 

Each mode has the same basic functions, but also dedicated 
functions: 

DisAssemble - Special keys: 

Any alpha-numeric keys: 

Pressing any of the normal keys will activate »Iine as- 
sembly« mode. This mode is like a norma! input line with 
all its special keys. Type the desired command and 
press <return>. If the command is invalid, no change will 
be made. 

Non alpha-numeric keys: (Eg. <cursor right>) 

Pressing any non aipha-numeric key will activate »line 
(^ assembly« mode. But instead of starting on a blank line 

as normal, the current assembly line is put in to the line 
buffer. This makes alteration of existing code easier. 
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General keys: 

<CTRL-Shift-B>: Change hex output to byte size 

<CTRL-Shift-W>: Change hex output to word size 

<CTRL-Shift-L>: Change hex output to longword size 

<DEL> Pressing <Del> will put a »NOP« 

instruction on the current address, 
and move the pointer to the next 
address. 

Hex/Ascii Dump - Special keys: 

<Shift left/right>: Jump to start/end of line. 

<Alt left/right>: Scroll screen left/right 

The following is an explanation of the global commands, the 
commands that can be used in all three modes (these are 
also the commands you will find in the »monitor« menu): 

DisAssem 

Change to »DisAssembly« mode. It is possible to change 
from one mode to another without leaving the monitor. So if 
you while you disassemble a program encounter something 
that does not look like machine language, just change to 
»ASCll« or »Hexdump« to analyze it more closely. 

HexDump 

Change to »HexDump« mode. 

AsciiDump 

Change to »AsciiDump« mode. 



C 



C 
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Jump Addr 

Jump to address. Type the desired address in the menu in- 
put line. If the address is invalid no action will be taken. The 
old address will be stored in the last buffer (see »Last Addr«), 
so that it is possible to return to the address you jumped from. 

Last Addr 

Return to the last address you jumped from. The »last« buf- 
fer can remember the 1 6 iast addresses. 

Mark!. .3 

Mark a location that you want to remember. Use the marks to 
change between two locations. 

Jump 1..3 

Jump to one of the marked locations. Another use of the 
mark is if you are looking at a dynamically changing data area. 
Each time you press »Jump« mark the screen will be updated, 
even if the address was not changed. 

QuickJump 

Normaiy When jumping you would have to type In the address. 
But this function works as follows: 

In »Disassem« mode: 

v. Get the rightmost longword accessed on the »current line«. 

If no longword is accessed, no jump is taken. 

Warning: It is NOT checked wether the memory area poin- 
ted to by the longword address Is legal. If the address is 
illegal it might cause a crash. 
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In »hex« or »ASCII« mode: 

The longword taken from the nearst even address pointed 
to by the cursor is copied to the »Jump Addr« prompt. To 
accept the jump press <return>. - 

esc 

Quit monitor, and return to the command line. 

Additional flags: 

»OnlyAscii« - If set only ASCII codes will be showed in the 
»ASCI1 dump«. Normaly alternate codes are 
shown as well. 

WARNING: With the monitor you can watch all memory locati- 
ons, and edit in these memory, locations even if they are not 
allocated to the system. Accessing non existing memory or I/O 
areas can cause a crash. 

Changing memory locations used by the system can also 
cause a crash, or make the system malfunction. The risk is 
that you will loose the current source in the editor. So make a 
safety backup of your source before using the monitor. 
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10 The Motorola MC68000 

The MC68000 is a 16/32 bit processor. This means that it 

communicates with the rest of the machine through a 16 bit 
data bus, but internal it communicates with full 32 bit. 

To specify where to address the main memory it has a 24 bit 
address bus. This gives a maximum workspace of 2 24 addres- 
ses = 16. Meg a Byte. 

The processor has the following registers: 



Data registers 


DO bis D7 


8, 16, 32 Bit 


Address registers 


A0 bis A7 


16, 32 Bit 


User Stack Pointer 


USP 


32 Bit 


Supervisor Stack 


SSP 


32 Bit I 


Program Counter 


PC 


24 Bit I 


Status Register 


SR 


16 Bit | 


Condition Code Register 


CR 


8 Bit | 



Data registers: (d0-d7) 

These registers can be used as both counters and constants. 
They can also be used in calculations, both logical and arith- 
metical. 
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Address registers: (a0-a6) 

These registers can be used as pointers and constants. They 
can be used in arithmetical calculations (not logical). 

Stack pointers: A7, USP, SSP 

There are two different stack pointers, »User« and 
»Supervisor«. The stack is used to store the return address 
from a subroutine. And can also be used to store registers. Q__ ! 

A bit in the status register selects what stack is used. Normally 
the user stack is used, but in interrupts, and other special rou- 
tines the supervisor stack is used (see »SR«). The current 
stack pointer is stored in »A7«, so it is dangerous to use this 
register in your routines. 

An little example that returns the return address from a sub- 
routine in »d0«: 

START BSR SUBROUT 
CONT RTS 

SUBROUT MOVE.L (A7) ,D0 . 
RTS 

Assemble this example and start it with »J«. Watch »D0« after 

the call. Try to print the label »CONT« with »?CONT«. Is it the 

same address? 

You can also store registers on the stack if you may not delete (_ J 

them: ■= 

START MOVEM . L DO ~A6 , - (A7 ) 

NOP ; Put your routine here 

MOVEM. L (A7)+,D0-A6 RTS 
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Status and Conditional Code Register: SR, CCR 

The »CCR« register is just the low 8 bits of the »SR« register 
so here follows a complete list of the meaning of each bit in 
the Status register: 



SR and CCR registers: 



C 



Bit 


Name 


Meaning 


J C, Carry 


Is set in calculations if result is to big. I 


1 V, Overflow 


Like carry but just on signed numbers. 


2 Z, Zero 


Set if the result of an operation is zero. 


3 


N, Negative 


Is set if the result is negative, highest bit. 


4 


X, Extended 


Is set in arithmetic calculations like carry; is I 
also affected by shift and rotate instructions. | 


5 -7 J Unused 


I 



The highest byte of SR: 



C 



Bit 


Name 


Meaning 


8-10 


10 - 12 


Interrupt level 12,11,10 defines a value from 
to 7, normal programs run at level 0. 


11 -12 


Unused 




13 


q Qimprvknr I Supervisor mode, if set, all privileged com- 
' ou Heiviaur mands can be executed and the )>ssp<< 

I stack is used 


14 


Unused | 


15 


T Trace "I '* se * * ne trace m °de is active. After each 
I instruction the trace exception is activated. 
J So that only one instruction is executed. 
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10.1 The Instruction Set 

First a little list of how to read the instructions: 



Label 


A label or address 


Ri 


Address or data register 


An 


Address register 


Dn 


Data register 


Source 


Source operand 


Dest 


Destination operand 


<ea> 


Effective address 


#n 


Integer value 


<list> 


A list of Rn. 

(eg. D0/D1-D4/A0-A3 This refers to registers DO D1 D2 
D3 D4 A0 A1 A2 A3, used in the »MOVEM« instruction) 



c 



Where ever you see the »ea« operand you can use all normal 
addressing modes. The possible addressing modes are: 



Addressing Mode 


Assembler-Syntax 


Data register direct 


Dn 


Address register direct 


An 


Register indirect 


(An) 


Register indirect with postincrement 


(An) + 


Register indirect with predecrement' 


-(An) 


Register indirect with displacement 


d!6(An) 


Register indirect with index 


d8 (An, Rn) 


Absolute Short 


XXXX . W 


| Absolute Long 


XXXXXXXX 


| PC relative with displacement 


dl6(PC) 


\ PC relative with index .. ... 


d8 (PC,Ra) 


| Immediate 


#xxxx 



c 
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In some instructions (Bcc, DBcc, Sec) we read »cc«. This 
means that instead of these two characters you write the 
conditional code: 



C 



cc 


Meaning 


Bits 


T 


True ■ 




F 


False 




HI 


Higher 


C* Z' 


LS 


Lower or Same 


c + z 


CC,HS 


Carry Clear, Higher or Same 


c 


CS,LO 


Carry Set, Lower than 


c 


NE 


Not Equal 


Z' 


EQ 


Equal 


z 


vc 


overflow Clear 


V 


vs 


overflow Set - - 


V 


PL 


PLus 


N' 


MI 


Minus 


H 


GE 


Greater than or Equal 


N*V+N'*V' 


LT 


Less Than 


N*V*+K' *V 


GT 


Greater Than 


N*V*Z ' +N' *V *Z' 


LE 


Less than or Equal 


Z + N*V'+N'*V 



c 



* = Logical AND, 
+ = Logical OR, " 
' = Logical NOT 
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Following here is a list of instructions of the MC68000 proces- 
sor, for more information consult the original documentation 
from Motorola Inc. 



Mnemonic 


Description 


ABCD 


Add binary coded decimal with extend 


ADD 


Add 


ADDQ 


Add quick 


ADDX 


Add with extend 


AND 


Logical AND 


ASL 


Arithmetic Shift Left 


ASR 


Arithmetic Shift Right 


Bco 


Branch 


BCHG 


Bit Test and Change 


BCLR 


Bit Test and Clear 


BRA 


Branch Allways 


BSET 


Bit Test and Set 


BSR 


Branch To Subroutine 


BSET 


Bit Test 


CHK 


Check Register Against Bounds 


CLR 


Clear Operand 


CMP 


Compare 


CMPM 


Compare memory 


DBcc 


Test Condition, Decrement and Branch 


DIVS 


Signed Divide 


DIVU 


Unsigned Divide 


EOR 


Exclusive OR 


EXG 


Exchange Registers 


EXT 


Sign Extend 


JMP 


Jump 


JSR 


Jump to Subroutine 


LEA 


Load Effective Address 


LINK 


Link Stack 


LSL 


Logical Shift Left 


LSR 


Logical Shift Right 


MOVE 


Move 


MOVEM 


Move Multiple Registers 



o 



c 
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C 
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Mnemonic 


Description 


MOVEP 


Move Peripheral Data 


MOVEQ 


Move Quick 


MULS 


Signed Multiply 


MOLU 


Unsigned Multiply 


NBCD 


Negate Binary Coded Decimal with extend 


NEG 


Negate 


NEGX 


Negate with extend 


NOP 


No Operation 


NOT 


One's Complement 


OR 


Logical OR 


PEA 


Push Effective Address 


RESET 


Reset External Devices 


ROL 


Rotate Left Without Extend 


ROR 


Rotate Right Without Extend 


ROXL 


Rotate Left With Extend 


ROXR 


Rotate Right With Extend 


RTE 


Return From Exception 


RTR 


Return and Restore 


RTS 


Return from Subroutine 


SBCD 


Subtract binary coded decimal with extend 


Sec 


Set Conditional 


STOP 


Stop 


SOB 


Subtract 


SUBO. 


Subtract quick 


SDBX 


Subtract with extend 


SWAP 


Swap data register halves 


TAS 


Test and Set Operation 


TRAP 


Trap 


TRAPV 


Trap on overflow 


1ST 


Test J 


DNLK 


Unlink j 



The above commands are only the 56 general types of com- 
mands that are available on the 68000. 
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In the above list some command types are written in different 
variations like »ADD«, »ADDQ« and »ADDX«. Actually there 
are more variations than these, but they are ignored by the 
assembler because it is easier for you not to think about what 
type of add you are using when they do exactly the same. 

An example of commands that are treated the same by the 
assembler: 

Add normal 

Add to address register t_ 

Add integer 

All the above commands are just treated like a normal add. 
And the normal ADD can also do all the addressing modes of 
the ADDA and ADDI instruction. This is most convenient for 
the programmer and it makes no problem at all. So you have: 

ADDA.W A0,A1 

is exactly the same as: 

ADD.W A0,Al 

You can write both, but it would be silly to force the program- 
mer first to tell that this is an add to a address register and 
then write the names of two address registers as operands. 

The only thing to remember, when you add to an address regi- 
ster is that it is only possible to add word and long size to it 
and that the word value is sign-extended to long before C_ 

added, so 

ADD.W #1000, AO 

ADD.L #1000, AO .... 

performs the same action, the word instruction is just shorter 
and faster. 
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10.1.1 Data Movement Instructions 

The following instructions .are used to transfer data between 
memory, data- or address-registers. 

The fundamental instruction in this category is the »move« in- 
struction. It can transfer byte, word or long data size. This can 
be done between two memory locations,, register-memory or 
register-register. . 

Some special move instructions allow you to set the 
» Condition Code« register (move <ea>,CCR) and also let you 
read the »SR« register, (move SR,<ea>). 

WARNING: This action is privileged on the MC68010 and later 
chips. 



C 



Mnemonic 


Syntax 




Size 


EXG 


EXG 


Rx, Rx 


1 L 


LEA 


LEA 


<ea>, An 


L 


MOVE 


MOVE 


<ea>, <ea> 


; B W L 




MOVE 


<e'a>, CCR 


w 




MOVE 


<ea>, SR 


w 




MOVE 


SR,<ea> . 


! w 




MOVE 


OSP,An 


L 




MOVE 


An,OSP 


! L 


MOVEM 


MOVEM 


<list>,<ea> 


I W L 


MOVEM 


MOVEM 


<ea>, <liat> 


W L 
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10.1.2 Integer Arithmetic Instructions 

The MC68000 can add, subtract, multiply, divide and compare 
two operands. It can also clear, test, sign-extend and negate 
a single operand. 

Some of these commands might demand a little explanation. 

Let's say you have two 64 bit numbers that you like to add. To 
do this the »ADDX« comes in handy because the following 
can be done. 

Let's say the first number is in »D0« and »D1«, and the fast 
number is in »D2« and »D3«. We want the result in »D2« and 
»D3«. The lowest number is placed in »D1«. We do like this: 

ADD.L Dl,D3 
ADDX.L D0,D2 

If a carry was set in the first addition, this will be added in the 
next addition. 

Also the »DIVS« and »DIVU« commands should be explai- 
ned. They divide a 32 bit constant with a 16 bit constant. The 
result is placed in the low 16 bit of the destination operand. In 
the upper 16 bit the remainder is stored. 

So the »MOD« function from Pascal can be made with only a 
few instructions. Normally we would have: 

Result =10 MOD 7 

We know this is the value »3« but the computer can also cal- 
culate this for us: 



C 



C 



104 



The Motorola MC68000 



START MOVEQ #10, DO 

MOVEQ #7,01 

DIVU 01,00 

CLR.W DO 

SWAP DO 

RTS ; The remainder »3« is now 

; placed in the longword »D0«. 



C 



C 



Mnemonic 


Syntax 


Size 


ADD 


ADD 


<»a>, Dn 


B H 1 




ADD 


Dn,<ea> 


B H L 


ADDA 


ADDA 


<««>, An 


H L 


ADDI 


ADDI 


#d,<«a> 


B W L 


ADDQ 


ADDQ 


|d,<«»> 


B W L 


ADDX 


ADDX 


Dy, Dx 


B H L 




ADDX 


-(Ay), -(Ax) 


B tf L 


CLR 


CLR 


<•«> 


B W 1 


CMP 


CMP 


<«»,Da 


B W L 


CMPA 


CMPA 


<«»>, An 


H L 


CMP I 


CMP I 


#d,<ea> 


B W L 


CMPM 


CMPM 


(Ay)+, (Ax)+ 


B H L 


DIVS 


DIVS 


<aa>,Dn 


W 


DIVU 


DIVU 


<«»>,Dn 


w 


EXT 


EXT 


Dn 


W L 


HOLS 


MULS 


<«l>,Dti 


ff 


MOLO 


MDLU 


<««>,Dn 


H 


NEG 


HEG 


<ea> 


B H L 


NEGX 


NEGX 


<»a> 


B W L 


SUB 


SUB 


<ea>,Dn 


B W L 




SUB 


Dn,<ea> 


B W L 


SOB A 


SOBA 


<«»>,An 


N L 


SOBI 


SUBI 


#d,<«a> 


B tf L 


SDBQ 


SDBQ 


#d,<«*> 


B H L 


SOBX 


SUBX 


Dy , D.x 


B tf L 




SDBX 


-(Ay), -(Ax) 


B If 1 


TAS 


TAS 


<ea> 


B 


TST 


TSS 


<»a> 


B W 1 
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10.1.3 Logical Instructions 

One common thing about all logical instructions is that they 
cannot use address-registers as operands. And they cannot 
do memory-to-memory operations. But they are stiil very po- 
werful and useful. If we think back at the »MOD emulation 

prog ram « from last chapter: 

Result =10 MOD 7=3 

If the question had been: 
Result = 10 MOD 8 ~ ? 

this could have been done with logical operations, here we go: 

START 



C 



MOVEQ 


#10, DO 


; number 1 


MOVEQ 


#8,D1 


; number 2 


SUBQ.L 


#1,D1 


; minus 1 


AND.L - 


D1,D0 




RTS 







As long as we have a value of 2,4,8,16... we can use logical 
operations because these values are exactly the maximum 
combinations in 1,2,3,4.. bits. 



Mnemonic 


Syntax 


Size 


AND 


AND 


<ea>, Dn 


B W L 




AND 


Dn,<ea> 


B H L 


AND I 


AND I 


#d,<ea> 


B W L 




AND I 


#d,SR 


B W 


EOR 


EOR 


Dn, <ea> 


B H L 


EORI 


EORI 


#d,<aa> 


B W L 




EORI 


#d,SR 


B W 


NOT 


NOT 


<ea> 


B W L 


I OR 


OR 


<«a>, Dxi 


B W L 


! 


OR 


Dn, <ea> 


B W L 


I ORI 


ORI 


#d,<ea> 


B W L 


I 


ORI 


#d,SR 


B W 



c 
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1 0. 1 .4 Shift and Rotate Instructions 

The shift and rotate instructions are also very powerful. With 
these instructions it is possible to get one bit from a 32 bit 
number at the time. You can- also divide a number by 2,4,8,16 
etc., because every time a number is shifted one to the right it 
is divided by 2. 

Division: 

r DIVU #8, DO as LSR.L #3, DO 

DIVS #8, DO = ASR.L #3, DO 

And where »DIVU« only is 16 bit »LSR.L« is 32 bit. 

The shift commands just shifts all bits in one direction and the 
spare bit is put into both the »C« and »X« flag: 

abcdefgh 
- nabcdefg C = h X = h 

In »LSR«, »LSL« and »ASL« n = 0, in »ASR« n = a. 

The rotate commands shifts like the shift commands, but the 
spare bit is put into the the other end. So if you rotate a byte 8 
bit left, you have the same byte again: 

abcdefgh 
= habcdefg C = h 

In »ROXL« and »ROXR« it is a iittle different, because here 
(^ the spare bit is put into the »X« flag in the old content of the 

»X« flag is shifted in. So you would have to »ROXR« a byte 9 
times to get the same byte again: 

abcdefgh 
= Xabcdefg C = h X = h 
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After next rotation: 

Xabcdefg 

= hXabcdef 



C = g X = g 



It is possible with rotate instructions to make a general 32 bit 
division routine: 

I expect you to put the two operands into »d0« and »d1«, this 
wiii result in d1 = d1/d0. 



DIVIDE32 : 






MOVEQ 


#32, D3 




MOVEQ 


#0,D2 


.LOOP 


SUB.L 


DU,D2 




BCC.B 


.OK 




ADD.L 


D0,D2 


.OK 


ROXL.L 


#1,D1 




ROXL.L 


#1,D2 




DBF 


D3, .LOOP 




NOT.L 


Dl 




RTS 





c 



So you see, it can become very short. 



j Mnemonic 


Syntax 


Size 


I ASL 


ASL Dx,Dy 


B W L 


| 


ASL #d,Dn 


B W L 


| 


ASL <ea> 


W 


\ ASR 


ASR Dx,Dy 


B H L 


i 


ASR #d,Dn 


B W L 


\ 


ASR <ea> 


W 


\ LSL 


LSL Dx,Dy 


B W L 


\ 


LSL #d,Dn 


B W L \ 


j 


LSL <ea> 


W \ 



c 
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Mnemonic 


Syntax 


Size 


LSR 


LSR Dx,Dy 


B W L 




LSR #d,Dn 


B W L 




LSR <ea> 


W 


ROL 


ROL Dx,Dy 


B W L 




ROL #d,Dn 


B W L 




ROL <ea> 


W 


ROR 


ROR Dx, Dy 


B H L 




ror #d,Dn 


B W L 




ROR <ea> 


H 


ROXL 


ROXL Dx,Dy 


B W L 




ROXL #d,Dn 


B W L 




ROXL <ea> 


W 


ROXR 


ROXR Dx,Dy 


B H L 




ROXR #d,Dn 


B W L 




ROXR <ea> 


W 



c 



If you shift 1 or 2 right it is faster to make an addition instead: 
You want: DO - D0*2 

Normally: 
LSL.W #1,D0 ; takes 8 cycles 

ADD.W DO, DO ; takes 4 cycles 

You want: DO = D0*4 

Normally: 
LSL.W #2, DO ; takes 10 cycles 

ADD.W DO, DO 

ADD.W DO, DO ; takes 8 cycles 

But if you use longword only DO = D0*2 is faster with addition. 
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1 0. 1 .5 Bit Manipulation Instructions 

The bit manipulation instructions are used to set, clear or 
change a specified bit in memory or a data register. 

In your programs you could perhaps use »D7« as a global 
status register that tells what things are on and what are off. 



CursorAn = 
BSET 



The Cursor is on 



#CursorAn,D7 

One smart thing about the bit instructions is that they test the 
state of the bit before altering it. 

So the following is possible: 



C 



BCLR #CursorOn , D7 
BNE TheCursorWasSet 



Clear cursor 



Mnemonic 


Syntax 


Size 


BTST 


BTST 


Dn, <ea> 


B L 




BTST 


#d,<ea> 


B L 


j BSET 


BSET 


Dn, <aa> 


B L 


| 


BSET 


#d,<ea> 


B L 


! BCLR 


BCLR 


bn,<ea> 


B L 


| 


BCLR 


#d,<ea> 


B L 


! BCHG 


BCHG 


Dn, <ea> 


B L 


i 


BCHG 


#d, <ea> 


B L 



c 



The long format is to registers only. 
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10.1.6 Binary Coded Decimal Instructions 

The »binary coded dec.ima1« is a special format that makes it 
easier for you to convert a number in memory to a decimal 
number on screen. 

Normally a byte can carry the value - 255, but in binary co- 
ded decimal it can oniy carry - 99. If we look at the two 
nibbles {4 bits) in a byte we only use the first 10 combinations 
in each nibble. 



Binary 


Binary coded decimal 


0000 0000 





0000 0001 


1 


0000 0010 


2 


0000 0011 


3 


0000 0100 


4 


0000 0101 


5 


0000 0110 


6 


0000 0111 


7 


0000 1000 


8 


0000 1001 


9 


0001 0000 


10 


0001 0001 


11 



c 



So if you want to convert a binary coded decimal byte to a 
string you can use the following program: 



BCDToStr : 

MOVEQ 
MOVE.B 



#0,DO 

BinByte,D0 



LSL.W #4,D0 



Zero DO 
; Put byte into 
; DO = $00xy 

Shift 4 left 

DO = $0xy0 
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LSR.B 
ADD.W 

MOVE.W 

RTS 
BinByte DC.B 

EVEN 
String DC.W 

If you have e.g. two 
wanted to add them 
the trick. 



#4, DO ; Shift 4 right 

; DO 85 $0x0y 

#'00', DO ; Add ASCII '00' 

; DO = $3x3y 

DO, String ; Store in memory 

4«4+6 



8 digit BCD numbers in memory and you 
together, the following program would do 



C 



AddBCD : 



BCDl 
BCD2 



LEA.L 

LEA.L 

MOVE.W 

ABCD 

ABCD 

ABCD 

ABCD 

RTS 

DC.L 

DC.L 



BCD1+3(PC) ,A0 

BCD2+3(PC) 7 A1 

#4,CCR 

-(A0),-(A1) 

-(A0),~<A1) 

-(A0),-(Al) 

-(A0),-(A1) 

$12345678 
$87654321 



Get address of 
Number 1 
Get address of 
Number 2 
Clear X-Flag 



| Mnemonic 


Syntax 


Size 


I ABCD 


ABCD Dx,Dy 


B 


| 


ABCD -{Ay), 


"(Ax) 


B 


| SBCD 


SBCD Dx,Dy 


B 




SBCD - (Ay) , 


-(Ax) 


B. 


| NBCD 


NBCD <ea> 


B 



c 
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10.1.7 Program Control Instructions 

Program control instructions are very helpful, and some of 
them have already been used in earlier examples. 

The instructions most used are the conditional instructions. 
These are the instructions ending with »cc«. Instead of »cc« 
you write a conditional name: EQual, NEqual etc. You can see 
all these names at the beginning of this chapter. When you 
use these you do like this: 



SUBQ.W 


#1,D0 


BNE 


NotFinished 


CMP.W 


D0,D1 


BHI 


Higher ; 



; Where Dl > DO ? 



Conditional Instructions: 



Mnemonic 


Syntax 


GroBe 


Boo 


Bco <Lab«l> 


B W (S L) 


DBce 


DBce Dn,<l,abel>- 


w 


Sec 


Scc <ea> 


B 



c 



Unconditional Instructions: 



Mnemonic 


Syntax 


GroBe | 


BRA 


BRA <Label> 


B'W {S L) \ 


BSR 


BSR ■ - <Label> 


B-W (S L) • | 


JMP 


JMP < ea> 


L | 


JSR 


jsr <ea> 


L j 



Return Instructions: 



| Mnemonic 


Syntax 


Aktion j 


j RTR 


RTR MOVE.W (SP)+,CCR 


MOVE.L (SP)+,PC| 


RTS 


RTS MOVE.L (SP)+,PC 


| 
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10.1.8 Link and Unlink Instructions 

These instructions are most used in high level language 
compilers link C and Pascal. They are used by subroutines to 
allocate space on the. stack. 

It is also possible to use them in your program: 

START MOVEM.L D0/Dl,-(sp) ; Parameter 1 + 2 

BSR.L DIVIDE 

RTS 

DIVIDE MOVEM.L D2/D3/A0, - (sp) 

LINK A0,#16 

MOVEM.L <sp)+,D0/Dl 

BSR.L DIVIDE32 ; An earlier made 

; routine 

UNLK A0 

MOVEM.L <sp)+,D2/D3/A0 

RTS 

This example might look a little messy. But in this way it is 
possible to put parameters to a subroutine on the stack. 



C 



Mnemonic 


Syntax 


Aktion 


LINK 


LINK An,#d 


MOVE.L An,-(SP) 






MOVEA.L SP,An 






ADD.W #d,SP 


UNLK 


UNLK An 


MOVE.L An,SP 




| MOVE.L ". {sp) +,An 



c 
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1 0. 1 .9 System Control Instructions 

One of the instructions in this category that deserves most 
explanation is the »STOP« command. It is privileged because 
it stores an immediate value into the status register. After this 
it stops all execution and fetching of instructions. The execu- 
tion is first started when a sufficiently high interrupt occurs. 
This instruction can be used to save valuable bus cycles. 

An other very important thing to keep in mind is that the 
»MOVE SR,<ea>« instruction is a privileged instruction on all 
later chips. So if yOu are making a program that you want to 
work on these later chips, don't use this instruction in user 
mode. 



Privileged Instructions: 



C 



Mnemonic 


Syntax 


Aktion 


RESET 


RESET 




RTE 


RTE 




MOVE.W (SP)+,SR 
MOVE.L (SP)+,PC 


STOP 


STOP 


#d 


MOVE.W #d,SR 
und Stop 


AND I 


AND I 


#d,SR 




EORI 


EORI 


#d,SR 




ORI 


ORI 


#d,SR 




MOVE 


MOVE 


<ea>, SR 






MOVE 


USP, An 


• 




MOVE 


An, USP 
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Trap-Generating Instructions: 



Mnemonic 


Syntax 


Aktion 


TRAP 


TRAP #<vector> 


. 


TRAPV 


TRAPV 


If V = 1 
then trap 


CHK 


CHK <ea>,Dn 





Status Register Instructions: 



Mnemonic 


Syntax 


Aktion 


AND I 


ANDI.B #d,CCR 




EORI 


EORI.B #d,CCR 




OR I 


ORI.B #d,CCR 




MOVE 


MOVE <ea>,SR 






MOVE SR,<ea> 


Privileged 
on MC68010 
and higher 



c 



10.2 Exceptions 

Normally when we want some special routine to be executed, 
we just execute it as a subroutine. If something special hap- 
pens, the processor can also execute some special routines, 
these are called exceptions. An exception routine is ended 
with a »RTE« instead of a »RTS« in a subroutine. 

The possible exceptions are: 



C 
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Vector 


Adress 


Assignment 





$000 


RESET: Initial SSP 


- 


$004 


RESET: Initial PC 


2 


$008 


Bus Error 


3 


$00c 


Address Error 


4 


$010 


Illegal Instruction 


5 


$014 


Zero Divide 


6 


$018 


CHK Instruction 


7 


$01c 


TRAPV Instruction 


8 


$020 


Privilege Violation' 


9 


$024 


Trace 


10 


$028 


LINE_A Emulator 


11 


$02c 


LINE_F Emulator 


12- 14 


$030 - $03b 


Reserved 


15 


$03c 


Uninitialized Interrupt 


16-23 


$040 - $05f 


Reserved 


24 


$060 


Spurious Interrupt 


25 


$064 


Level 1 Interrupt Autovector 


26 


$068 


Level 2 Interrupt Autovector 


27 


$06c 


Level 3 interrupt Autovector j 


28 


$070 


Level 4 Interrupt Autovector j 


29 


$074 


Level 5 Interrupt Autovector I 


30 


$078 


Level 6 Interrupt Autovector 


31 


$07c 


Level 7 Interrupt Autovector [ 


32-47 


$080 - $0bf 


TRAP instruction vectors 


48-63 


$0c0 - $0ff 


Reserved | 


64 - 255 




$100 - $3ff 


User Interrupt J 
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Given below is a short explanation to each individual excep- 
tion. 



RESET: Initial SSP 

When a reset is made the initial stack pointer is fetched from 
here. If you look in address $0000 and $0004 you will not find 
the »SSP« and »PC«. This is because that the Amiga has a 
special boot ROM that is put down here when a reset is made. 

RESET: Initial PC 

When a reset is made the initial program pointer is fetched 
from here. If you look in address $0000 and $0004 you will 
not find the »SSP« and »PC«. This is because that the Amiga 
has a special boot ROM that is put down here when a reset is 
made. 

Bus Error 

This exception is evoked if a reserved or not existing memory 
area is accessed. 

Address Error 

If an odd address is accessed this error is evoked. 

Illegal Instruction 

An illegal instruction is a 16-bit binary pattern that does not re- 
present one of the legal opcodes in the 68000 instruction set. 
One opcode is reserved as illegal ($4afc). In assembly lan- 
guage this is called »ILLEGAL«. 
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Zero Divide 

If a division by zero occurs (eg. DIVS #0,d0) this exception is 
evoked. 



CHK Instruction 

The »CHK« instruction can cause an exception through this 
vector. The »CHK« instruction checks data register bounda- 
ries. On overflow the exception is generated. 



TRAPV Instruction 

The »TRAPV« instruction can cause an exception through this 
vector. The »TRAPV« instruction will cause this exception if 
the »V« (overflow) bit is set in the »CCR« registers. 



Privilege Violation * 

If you activate a privileged instruction in user mode this excep- 
tion is executed. Some privileged instructions are »RESET«, 
»MOVE.W #0«, »SR«. 

Trace 

If the trace mode is enabled, an exception will be generated 
C through this vector each time a command has been executed. 
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LINE_A Emulator 

Not all possible opcodes are used on the MC68000 processor, 
some are reserved for later use. Especially all commands star- 
ting with the bit combination »%1010« or »%1111«. All com- 
mands starting with »%1010 = $A« are called »UNE_A« 
commands. You can use these commands to make your own 
commands or to emulate floating point commands. 

LINE_F Emulator 

Not all possible opcodes are used on the MC68000 processor, 
some are reserved for later use. Especially all commands star- 
ting with the bit combination »%1010« or »%1111«. All com- 
mands starting with »%1111 - $F« are called »L!NE_F« 
commands. You can use these commands to make your own 
commands or to emulate floating point commands. 



C 



C 
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1 1 Programming By Examples 

In this chapter we will look at different programming technics, 
and at different ways to solve several programming problems. 

On the disk are some examples in the »Examples« -directory. 
These are as follows: 

GettingStarted.S 

This is a source based on the SystemStartup routine. It makes 
a fractal picture just to show off. 

SystemStartUp.S 

!f you are making a system program there are some basic 
routines you will always need. Most of these are placed in this 
source. 

BinaryConv.S 

Convert a register value into a binary ASCII string. A small ex- 
ample recommended as a first test of the debugger. 

BootBlock.S 

Create your own bootbiock, with your own text. 

C NonSystemStartUp.S 

Whenever you are making a hardware based program or rou- 
tine, this general »startup routine« will come in handy. 

ScrollExample.S 

This is a small scroll text routine based on the » Non-System 
startup« routine. 
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LineDraw.S 

Like the »ScroIIExample« this small routine is based on the 
» Non-System startup« routine. 

WindowExample.S 

This is an example using include files. It opens a window, 
reads a text string from the keyboard and prints it again. 

Di rector y.S C 

This is based on include files like the window example. It 
opens a window and prints the directory into this window. 

The above examples are self-explaining and are put on the 
disk because they were to large to print. You can use these 
sources in your own programs, but 1 think that you should only 
try to understand them and use what you have learned to 
make your own programs. 

This is also the intention of the programs printed in this ma- 
nual. It is of course possible to optimize many of these pro- 
grams, but I think that it was more important to make several 
different programs solving different problems, than making a 
few highly optimized ones. 

The following programming examples can be divided into 
three different categories: 

General examples: Programs that can be used on any (_ 

MC68000, computer 

System programming: Programs using the Amiga opera- 
ting system 

Hardware programming: Programs using the Amiga hard- 
ware directly 
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11.1 General Examples 



In the following examples we will discuss different ways of sol- 
ving a few simple problems. The execution time of each rou- 
tine will also be calculated so that it is possible to estimate 
wich routine is the fastest. If you are a total newcomer to 
machine code, skip this sub-chapter and return to it later when 
you have acheived the necessary skills. 



11.1.1 Longword multiply 

The MC68000 is only capable of multiplying two 16bit num- 
bers, but in some applications it is necessary to multiply 32bit 
numbers. So here is first some theory: 

We look at two 2 digit numbers, each digit is shown with a 
letter: 

xy * mn 

If we want to multiply these two numbers but only know how to 
multiply one digit numbers we can do as follows: 

I x | y | 
* I m | n | 



I y*n 


I 


I x*n | 


* 10 


I y*m I 


* 10 


x*m | 


* 100 



= I . a I b I c I d. I 

So we see that we get a four digit number. Instead of looking 
at digits we look at 16bit numbers. The following programs 
multiply 32bit numbers with the help of four 16bit multiplicati- 
ons: 
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We have: 


HiWord 1 


LoWord 






bo = 


x | 


y 






Dl = 


m 


n 





The result will be placed in DO (high 32bit) and D1 (low 32bit). 

MULU32 MOVEM.L D2/D3/D4, - (A7) 



MOVE.W 


D1,D2 


MOVE.L 


D1,D3 


SWAP 


D3 


MOVE.W 


D3,D4 


MULU 


D0,D1 


MULU 


D0,D3 


SWAP 


DO 


MULU 


D0,D2 


MULU 


D4,D0 


SWAP Dl 




ADD.W 


D2,Dl 


CLR.W 


D2 


SWAP 


D2 


ADDX . L ' 


D2,D0 


ADD.W 


D3,D1 


CLR.W 


D3 


SWAP 


D3 


ADDX.L 


03,00 



SWAP 



MOVEM.L 
RTS 



Dl 



A7) 

d2 = n 

dl - n 
d3 = m 
d4 = m 


Save used 
registers 


dl = y*n 
d3 = y*m 




d2 = x*n 

dO = x*m 





c 



dl = dl. + d2«16 



dO = dO + d2»16 
+ Carry 



dO = dO + d2»16 

+ Carry 

Dl in correct order 

again. 



C 



<A7)+,D2/D3/D4 
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This was the 32bit unsigned multiply using only 5 registers. 
You can also make a signed multiply but I will leave this as an 
exercise. For fun 1 have calculated the maximum execution 
time, it was 432 cycles. But if you use it as a macro (without 
the »RTS«) and allowing »d2«, »d3« and »d4« to be altered, 
it takes a maximum of 348 cycles. It is a maximum because 
»MULU« takes a maximum of 70 cycles. ■■■■■ 

It is also possible with this principle to write a program that 
multiplies bigger numbers than 32bit, but numbers with that 
precision are very rarety used. Normally you would use floating 
point instead. 

11 . 1 .2 Longword Division 

Now when we are talking about 32bit arithmetics I will repeat 
the division routine from the chapter about the Motorola 
instruction set. But this time just in a slightly optimized version. 

The calculation is as follows: D1 = D1/D0 



DlVlDE32b : 




MOVEQ 


#0,D2 


REPT 


32 : . 


SUB.L 


D0,D2 


BCC.B 


*+2 


ADD.L 


D0,D2 


ADDX.L 


D1,D1 


ADDX.L 


D2,D2 


ENDR 




NOT.L 


Dl 



Jump to current 
adress +2 



This routine will take a maximum of 1288 cycles, (a minimum 
of 1096). , - . . 
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11.1.3 Delete, Copy and Compare 

After implementing these simple mathematical routines, a dif- 
ferent area of exercise would be nice. Another important field 
is deleting, copying and comparing data lists. First we look at 
delete. 

Before you choose the method of deleting you must think ca- 
refully about the problem. What part of the problem is always 
constant? Let's say you want to delete the screen memory. 
You could use the .blitter, but what if the blitter was busy wor- 
king with something else? 

The first try might be to make a loop like this: 

CLEARl LEA.L SCREEN, AO 

MOVE.W #80*200-1, DO . ; Bytes - 1 

.LOOP CLR.B {A0) + 

DBF DO, .LOOP . 

This could be improved dramatically if you have deleted an 
entire longword at the time with »MOVE.L D1,(A0)+«. Do not 
use »CLR.L (A0)+« because the »clr« instruction performs a 
read cycle before each write. 

You could perhaps repeat the instruction many times so that 
you could save the clock periods of the »DBF« instruction like 
this: '' 

CLEAR2 



MOVEQ 


#0,D0 


LEA.L 


SCREEN, AO 


REPT 


80*200/4 


MOVE.L 


DO, (A0)+ 


ENDR 




RTS 





This would allow you to delete 2387000 bytes/second. But this 
program would use 12800 bytes! 
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C 



It can be done faster, if you use the »MOVEM« command and 
move all blank registers with this command: 

CLEAR3 



MOVEM.L 


BLANK, D0-A1 


LEA.L 


SCREENEND,A2 


REPT 


2*200 


MOVEM.L 


D0-A1,-(A2) 


ENDR 




RTS 





This routine fills 3240000 bytes/sec. and uses 1600 bytes. 

This example was about a data field that you knew everything 
about. Let's take a string that you know nothing about. Your 
routine is called with a position and a length, nothing more. 
Here we could again use the »CLEAR1« routine, but this rou- 
tine can stil! become faster. The first approach to this could be 
to repeat the clear instruction several times. You call this 
routine with a pointer in »A0« and a length in »D0«: 



CLEARl . 2 










MOVEQ 


#0,D1 


r 


Fill valuer 




SUBQ.L 


#8, DO 


t 


Dekrement counter 
by 8 




BMZ.B 


. NOMORE 


t 


No more 8 ? 


.LOOP 


REPT 


8 








MOVE . B 


Dl, (A0)+ 


t 


Clear 8 bytes 




ENDR 










SUBQ.L 


#8, DO 


; 


take 8 more 




BPL.B 


.LOOP 


r 


finished 


.NOMORE 


ADDQ.L 


#7, DO 


t 


How many left? 




BMI.B 


.FINI 


I 


no one? 


. LOOP 2 


MOVE.B 


Dl, (A0) + 


; 


clear the few left 




DBF 


DO, .LOOP2 




; Loop 


.FINI 


RTS 
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This routine is quite fast, but it it can become several times fa- 
ster if the address is first aligned so that you can use longword 
instructions instead: 

A schematic program is made here below. The program is not 
coded, this is left as an exercise to you. Note that it is better if 
you longword-aiign the address rather that just word aligning it, 
because on sophisticated processors like MC68020/30/40 the 
»MOVE.L« is faster accessing a iongword-aligned address. 

This is because these processors are 32bit, and a longword C 

write to a non-longword-aligned address would take 2 memory 
write cycles. 

cleari . 3 



Longword align address by clearing to 3 bytes, 
Clear max number of longwords. 



Clear the last to 3 bytes. 



RTS 



This routine is faster if the area is large, i.e. more than 10-20 
bytes. This depends on the way you have implemented it. If 
implemented right, this routine will be 3 times faster than the 
above routine and 7 times faster than »CLEAR1«. 

The above algorithms can also be used to make memory 

move and compare. I will only show you how to implement a (__ 

useful copy routine with the principle used in »CLEAR1.2«, 

You call this routine with a pointer in »A0« (source) and in 
»A1« (destination) and a length in »D0«: 
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COPYl . 2 








SUBQ.L 


#8, DO 




BMI . B 


. NOMORE 


. LOOP 


REPT 


8 




MOVE.B 


(A0)+, (Al) + 




ENDR 






SUBQ.L 


#8, DO 




BPL.B 


.LOOP 


.NOMORE 


ADDQ.L 


#7, DO 




BMI . B 


.FINI 


. LOOP 2 


MOVE.B 


(A0)+, (Al) + 




DBF 


DO, .LOOP2 


.FINI 


RTS 





c 



11. 1.4 Sorting 

Sorting is a very important subject and there exist many 
different algorithms to do this. One of the very easy and very 
well known is the algorithm »Bubble Sort«. This is as follows: 

We look at the following five numbers: 

34251 

Bubble sort looks at two numbers and swaps them if the first 
was bigger. After the look at the first it looks at trie next pair 
etc. If after looking at all pairs no one was swapped, the num- 
bers are sorted. Like this: 



324 15 
2 3 14 5 
21345 
1 2345 

12345 



Changes: 4-2 5-1 
Changes: 3-2 4-1 
Changes: 3-1 
Changes: 2-1 
Changes: none 
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You see that it took 5 runs to sort 5 numbers this is »5*5=25« 
compares. We say that the time complexity for this routine is 
»0(n*n)«. This means that if there are »n« elements it will take 
n*n processes to sort the »n« numbers. So if one process ta- 
kes 72 cycles (100,000 processes/second) it will take 10 se- 
conds to sort 1000 elements. 

The bubble sort routine can be implemented in another way 
that is more efficient. 

The first we see about the routine is that the following two lists (_ 

with only one wrong placed number are sorted in totally diffe- 
rent times: 

5 12 3 4 Sorted in 2 runs 

2 3 4 5 1 Sorted in 5 runs 

A little simple change can be made to bubble sort to improve 
this fact. If we first run »left-right« and second »right-left« and 
repeat this sequence until no elements are swapped the exe- 
cution time will be shorter: . 

51234 ■ Sorted in 2 runs 

2 3 4 5 1 Sorted in 3. runs 

We can try this new method with the first data row »3 4 2 5 1 « 

3 2 4 15 Changes: 4-2 5-1 
13 2.4 5 Changes: 4-1 2-1 3-1 
12 3 4 5 Changes: 3-2 
12345 Changes: NONE 

Now we only used 4 runs instead of 5 before. 

If we wanted to be more advanced we could remember the 
first position where we had to change the first element, and 
with next run we wili only have to start at the position »one« 
before this place. This would prevent us from comparing ele- 
ments that are already sorted.' 
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We could check even more things, but we have to think 
about, that if the routine has to check a lot of things, it is not 
sure that it becomes faster just because it only has to check 
half, the elements. The Bubble Sort implementation 1 usually 
use is the following: 

Check the two elements. If they are swapped went one step 
back if not one step forward. The list is sorted when the end is 
reached. (Simple !} My results with this routine are very good: 
Usually 4r5 times faster than the implementation I first told you 
about. Coded in 6800.0 code it looks like this: 



C 



BUBBLE_ 


_A_LA_RUNE : 








" LEA 


ListStart,A0 


A0 = Start ptr 




LEA 


ListEnd,Al 




Al = End ptr 




MOVEQ 


#ElemLen,Dl 




Dl = Element 
length 




MOVE.L 


A0,A2 


A2 = Actual element 






; 


pointer 




MOVE.L 


A0,A3 






ADD.L 


D1,A3 


A3 = Next element 






; 


pointer 


.LOOP 


MOVE.B 


(A3), DO 






CMP.B 


(A2),D0 


First =< Next 




BLO.B 


. CHANGE 


No change 




ADD.L 


D1,A2 






ADD.L 


D1,A3 






CMP.L 


A3 , Al 


End reached? 




BNE.B 


. LOOP 


No loop 




RTS 






.CHANGE 


MOVE.L 


D1,D2 


Swap elements 


. LOOP2 


MOVE.B 


(A2),D0 






MOVE.B 


(A3), (A2)+ 






MOVE.B 


DO, (A3) + 






SUBQ.L 


#1,D2 






BNE.B 


.LOOP2 
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SUB.L 


D1,A2 






SUB.L 


D1,A3 






CMP.L 


A2,A0 


/ 


At first element? 


BEQ.B 


.LOOP 


; 


Yes 


SUB.L 


D1,A2 


i 


One element forward 


SUB.L 


Dl,A3 


; 


One element back 


BRA.B 


.LOOP 


; 


Go again 



This implementation is very general. If you only want to sort 

elements of a fixed length and these elements have an even 

lenght you can make a fixed swap routine using longwords. C 

But the above routine will work of course. Bubble sort is best 

when you have small data areas or bigger areas if they are 

almost sorted. 

1 1 .2 System Programming 

The Amiga system has a lot of possibilities, and it is far to 
komplex to describe it in detail. This chapter will just give a few 
simple examples of what you can do with the system. For 
more details about the system consult the »ROM kernel 
manuals« from Commodore. 

The system is based on different libraries. Most of them are 
placed in the ROM, but some of them are also placed in the 
»libs« directory on the disk. Before you can use a library you 
have to load it. The most common libraries are as follows: 

exec, library 

This is the basic library. With this library you can open other li- 
braries, allocate memory, create tasks etc. 

dos.library 

Contains basic input/output routines like disk and screen com- 
munication. 
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intuition.library 

Handles all creation of screens, windows, menus etc. 

graphics.Mbrary 

Contains routines to draw lines, circles, to fill scroll, delete etc. 

layers.library 

Used to handle modification of the screen memory. 

diskfont.library 

This library is kept on the disk. It contains routines to handle 
new fonts for use in your programs. 

icon.library 

A library which can create and modify icons on the workbench 
screen. 

translator. library 

Is used together with the speech synthesizer. It translate the 
written word into phonetic symbols. 

mathffp.library 

Basic floating point calculation routines. 

mathieedoubbas.library 

Basic integer calculation routines. 

mathtrans.library 

Advanced floating point calculation routines, like SIN, COS, 
LOG, EXP etc. 
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There are several other libraries. But the above are the most 
common ones. Normally, when you use these libraries you 
use the include files placed on the disk. The include files are 
like normal source codes, but they contain only constant defi- 
nitions and macro difinitions. 

Before you ever use any include file, you will have to set the 
path of where to get the include files from. This is done with 
the following command: 

INCDIR dfO : include/ 

This is where you normally will get the include files from. Now 
we can include the files that we are going to use in the next 
examples: 

include exec/exec_lib . i 

include libraries/dos_lib.i 

include libraries/dos . i 

include intuit ion/ intuit ion_lib . i 

include intuition/intuition. i 

To. open a library you issue the following commands. We want 
to open »dos.library«: 



C 



DOS_LIBOPEN 

LEA.L 



_DOSNAME(PC) ,A1 ; Al=> 
; dos . library 



MOVEQ #0,D0 
CALLEXEC OpenLibrary 
MOVE.L DO, DOSBASE 



BEQ.L 



RTS 



ERROR ERROR 



; Version 
Open library 
_dosbase => 
library 
?? No pointer 
returned ! 
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DOSNAME DOSNAME 



DOSBASE DC.L ; 



Examples 

Dosname is a makro 
containing the string . 
' dos . library ' , 
Pointer to the library 



After calling this program, a pointer to the library is returned. If 
the library was not found, a »zero«. will be returned. If 
»dos.library« is not found, something is really wrong. 

If you had not used include files the routine would look like 
this: 

OpenLibrary = -552 

DOS LIBOPEN NO INCLUDE: 



LEA.L 

MOVEQ 
MOVE . L 

JSR -., 

MOVE.L 

BEQ.L 

RTS 

_DOSNAME DC.B 

DOSBASE DC.L 



_DOSNAME(PC) ,A1 ; Al => 
; dos . library 

#0,D0 ; Version 

$4.w,A6 ; Get pointer to 
; exec. library 

OpenLibrary (A6) ; Open the 

; library 

D0,_DOSBASE ; _dosbase=> 

; library 

ERROR_ERROR ; ?? No pointer 
; returned ! 



' dos . library ' 



; Name with 
lower case only! 
Pointer to the 
library 



The advantage with include files is that you don't have to 
remember the library offsets. In this case »OpenLibrary= - 
552« all the time. But the above program shows more about 
how the libraries work. 
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The only library we know the address of is the »exec.library«. 
This pointer is kept in address »$4«. »Exec« can do a lot of 
things, what can be found in the include file called: 
»exec_lib.i«. When even you want to call an exec routine you 
will have to call »Execbase + Offset«. All offsets are negative, 
so the address you call is lower than the pointer to the library. 
Each library offset is decremented with 6 starting from -30. 
The first few entries in »exec. iibrary« are as follows: 

Supervisor = -30 
Exitlntr = -36 

Schedule = -42 

And very long down in the list we got: 
OpenLibrary = -552 

If we looked at the address »ExecBase-552« we would see 
something Tike this: 

$0000044E JMP $00005E3A ; Dont count on 

, this. Different versions 
; of the system changes this 

So we see that we call just a »jump command« that calls the 
routine we want to execute. 

In the rest of the examples I will use definitions from the 

include files. If you want to see exactly what is done just di- 
sassemble the routines. To see all the include definitions, as- 
semble and type »=S«. 

Now, after opening the library, we would have to make a rou- 
tine that close it again when we dont want to use it any more. 

DOS_LIBCLOSE 

MOVE.L _DOSBASE(PC) ,Al ; Pointer 

; to the library 

CALLEXEC CloseLibrary ; Close it! 
RTS 
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After having opened »dos library« we can easily open a win- 
dow on the workbench screen. 

WINDOWJDPEN 

MOVE.L #_WIND0WNAME,D1 ; Window 

; definitions 
MOVE.L #MODE_OLDFILE,D2 ; Mode old 
CALLDOS Open 
MOVE.L D0,_WINDOWHANDLE ;The returned 

; Window handle 
BEQ.L ERROR ; 0, if the window 

; wasn 't opened 
RTS 

_WINDCWNAME DC .B 'CCN : 10/10/600/100/My window' , 

JflNDCWHANDLE DC .L 

Here is a routine to close the window. 

WINDOW_CLOSE 

MOVE . L _WINDOWHANDLE (PC) , Dl 

CALLDOS Close 

RTS 

After you have opened the window please remember that the 
window will appear behind the ASM-ONE-screen. So use the 
mouse to drag it down. You can do a lot of things with win- 
dows, the routine below can print a text in the window: 

TEXT_WRITE 

MOVE.L #TEXT,D2 ; Pointer to text 

MOVE.L #TEXT_END-TEXT,D3 ; Text lengh 

MOVE.L _WINDOWHANDLE,Dl / Wind, handle 

CALLDOS Write ; Write the text 
RTS 

TEXT ,-, DC.B 'Hello, this is a text' 

TEXT_END 

To see a program that does it all, try to run the example called 
»WindowExamp!e.S« or »Directory.S«. 
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1 1 .3 Hardware Programming 

As mentioned in the first chapter, one of the reasons for pro- 
gramming in machine language is that you can easily get ac- 
cess to the computer's custom chips. This chapter will only 
contain a small introduction on how to access some of the 
special purpose registers in the Amiga. Because of the limited 
space and the complex subject not all registers will be explai- 
ned. For further information you will have to get yourself a 
copy of the >» Amiga Hardware Manual«. 

Normally when you code using direct access to the custom 
chips, you will have to close down the system. This is the only 
way to be sure that nothing suspicious will happen. Anything 
can be done using library calls, but some coders like to know 
exactly what the machine is doing. If you access the chips di- 
rectly, you are able to make very specialized routines that 
might run a little faster than the system routines, but then you 
are not insured that the routine will work on future releases of 
the machine. On the other hand, even if you are going to 
code using only system routines, it is a big help to understand 
exactly how the machine is working. 

On the disk is placed a file called »NonSystemStartUp.S«. 
This file contains routines that close down the system enab- 
ling, you to start your own routines in a totally clean environ- 
ment. After pressing the left mouse button, it reopens the C 
system into its old state. 

Below is a list of all registers placed as offsets from the base 
address »$DFF000«. If you want to access »BplConO« you 
would have to access address »$dff100«. 
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NAME 


ADD 


R/W 


Function 


BLTDDAT 


$000 


ER 


Blitter destination early read 


D MACON R 


$002 


R 


DMA control read 


VPOSR 


$004 


R 


Read Vert Most sig. bit 


VHPOSR 
DSKDATR 


$006 


R 


Read vert and horiz pos of beam 


$008 


ER 


Disk data early read 


JOY DAT 


$00A 


R 


Joy-Mouse data 


JOY1DAT 


$ooc - 


R 


Joy-Mouse 1 data 


CLXDAT 


$00E 


R 
R 


Collision data reg (read & clear) 
Audio, disk control read 


ADKCONR 


$010 


POTODAT 


$012 


R 


Pot counter pair data 


POT 1 DAT 


$014 


R 


Pot coubter pair 1 data 


POTINP 


$016 


R 


Pot pin data read 


SERDATR 


$018 


R 


Serial port data and status read 


DSKBYTR 


$01A 


R 


Disk data byte and status read 


INTENAR 


$01C 


R 


Interrupt enable bits read 


1NTREQR 


$01E 


R 


Interrupt request bits read 


DSKPT 


$020 


W 


Disk pointer (longword) 


DSKLEN 


$024 


W 


Disk length 


DSKDAT 


$026 


w 


Disk DMA data write 


REFPTR 


$028 


w 


Refresh pointer 


VPOSW 


$02A 


w 


Write vert most sig bit 


VHPOSW 


$02C 


w 


Write vert and horiz position 


COP CON 


$02E 


w 


Coprocessor control register 


SERDAT 


$030 


H 


Serial Port data and stop bits write 


SERPER 


$032 


W 


Serial port period and control 
Pot' count start 


POTGO 


$034 


W 


JOYTEST 


$036 


W 


Write to all 4 mouse counters at once 


STREQU 


$038 


S 


Strobe for horiz sync (VB & equ) 


STRVBL 
STRHOR 


$03A 


s 


Strobe for horiz sync (VB) 


$03C 


s 


Strobe for horiz sync 


STRLOHG 


$03E 


s 


' Strobe for long horiz. line. 


BLTCONO 


$040 


w 


Blitter control register 


BLTC0N1 


$042 


w 


Blitter control register 1 


BLTAFWM 


$044 


w 


; Blitter first word mask for source A 


BLTALWM 


$04 6 "' 


H 


Blitter last word mask for source A 


BLTCPT 


$048 


w 


Blitter source C pointer (longword) 
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NAME 


ADD 


R/W 


Function 


BLTBPX 


$04C 


w 


Slitter source B pointer (longword) 


BLTAPT 


$050 


w 


Slitter source A pointer (longword) 


BLTDPT 


$054 


H 


Blitter dest. D pointer (longword) 


BLTSIZE 


$058 


w 


Blitter start and size (width.higth) 


BLTCMOD 


$060 


w 


Blitter source C modulo 


BLTBMOD 


$062 


w 


Blitter source B modulo 


BLTAMOD 


$064 


w 


Blitter source A modulo 


BLTDMOD 


$066 


w 


Blitter dest. D modulo 


BLTCDAT 


$070 


w 


Blitter source C data 


BLTBDAT 


$072 


w 


Blitter source B data 


BLTADAT 


$074 


w 


Blitter source A data 


DSKSYNC 


$07E 


w 


Disk sync pattern register 


COP1LC 


$080 


w 


Copper pointer 1 (longword) 


COP2LC 


$084 


w 


Copper pointer 2 (longword) 


COPJMP1 


$088 


w 


Restart at pointer 1 


COPJMP2 


$08A 


w 


Restart at pointer 2 


COP IMS 


$08C 


w 


Copper inst. fetch identify 


DIWSTRT 


$08E 


w 


Display window start (vert-hor) 


DIWSTOP 


$090 


w 


Display window start stop (vert-hor) 


DDFSTRT 


$092 


w 


Bit plane data fetch start 


DDFSTOP 


$094 


H 


Bit plane data fetch stop 


BMACOH 
CLXCON 


$096 


H 


DMA control write 


$098 


w 


Collision control 


INTENA 


$09A 


w 


Interrupt enable bits 


INTREQ 


$09C 


H 


Interrupt request bits 


ADKCON 


$09E 


W 


Audio, disk, UART control 


AODO 


$0A0 




Audio channel start address ' 


AUDI 
A0D2 


$0B0 




Audio channel 1 start address 


$0C0 




Audio channel 2 start address 


AUD3 


$0DO 




Audio channel 3 start address 


ADDxPTR 


+ $00 


W 


Audio channel x pointer 


AODxLEH 


+ $04 


W 


Audio channel x length 


AUDxPER 


+ $06 


w 


Audio channel x period 


AODxVOL 


+ $08 


w 


Audio channel x volume 


ADDxDAT 


+ $0A 


H 


Audio channel x data 
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NAME 


ADD 


R/W 


Function 






BPL1PT 


$0E0 


w 


Bitplane 1 pointer 




BPL2PT 
BPL3PT 


$0E4 


w 


Bitplane 2 pointer 




$0E8 


H 


Bitplane 3 pointerO 






1BPL4PT 


$OEC 


H 


Bitplane 4 pointer 






BPL5PT 


$OF0 


W 


Bitplane 5 pointer 






BPL6PT 


$0F4 


W 


Bitplane 6 pointer 






BPLCONO 


$100 


w 


Bit plane Ctrl reg (misc Ctrl bits) 






BPLCON1 


$102 


w 


Bit plane Ctrl reg (scroll value) 






BPLCON2 


$104 


H 


Bit plane Ctrl reg (priority Ctrl) 






BPL1MOD 


$108 


w 


Bit plane modulo (odd planes) 






BPL2MOD 


$10A 


w 


Bit plane modulo (even planes) 






BPL1DAT 


$110 


w 


Bit plane 1 data (parallel to serial) 






BPL2DAT 


$112 


w 


Bit plane 2 data (parallel to serial) 






BPL3DAT 


$114 


w 


Bit plane 3 data (parallel to serial) 






BPL4DAT 


$116 


H 


Bit plane 4 data (parallel to serial) 






BPL5DAT 


$118 


W 


Bit plane 5 data (parallel to serial) 






BPL6DAT 


$11A 


w 


Bit plane 6 data (parallel to serial) 






SPROPT 


$120 


H 


Sprite pointer 






SPR1PT 


$124 


W 


Sprite 1 pointer 






SPR2PT 


$128 


w 


Sprite 2 pointer 






SPR3PT 


$12C 


w 


Sprite 3 pointer 






SPR4PT 


$130 


H 


Sprite 4 pointer 






SPR5PT 


$134 


w 


Sprite 5 pointer 






SPR6PT 


$138 


w 


Sprite 6 pointer 






SPR7PT 


$13C 


w 


Sprite 7 pointer 






SPRO 


$140 




Sprite area 






SPR1 


$148 




Sprite 1 area 






SPR2 


$150 


Sprite 2 area 






SPR3 


$158 




Sprite 3 area 






SPR4 


$160 


J Sprite 4 area 






SPR5 


$168 


Sprite 5 area 






SPR6 


$170 


| Sprite 6 area 






SPR7 


$178 


| Sprite 7 area 
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NAME 


ADD 


R/W 


Function 


SPRxPOS 


+ $00 


H 


Sprite x Vert-Horiz position 


SPRxCTL 


+ $02 


W 


Sprite x stop pos & control j 


SPRxDATAA 


+ $04 


H 


Sprite x image data a ] 


SPRxDATAB 


+ $08 


W 


Sprite x image data b ] 


COLOR 


$180 


W 


Color j 


COLORl 


$182 


w 


Color 1 j 


bia I J 




COLOR31 


$1BE 


H 


Color 31 s 


SPECIAL 


$1DC 


W 


NTSC control on Fatter Agnus ( 



c 



The next programming examples can only be understood if 
you, while reading, also consult a Hardware Reference Ma- 
nual. See the appendix about recommended literature 

Before we really start with non-system programs, I will show 
you some very small examples of how to get simple reactions 
from the hardware. 

One of the first and most simple things we can do is to make 
routines what can check the fire buttons on the mouse and 
joystick. 

To do this we have to look at a new register. This is placed at 
address »$bfe001«, it has the following layout: 



I Bit 


Function 


7 


Game port 1 (fire button) 


6 


Game port (tire button) 


[ 5 


Disk ready 


I 4 


Disk track 00 


I 3 


Write protect 


I 2 


Disk change 


i 1 


Led light (0 = tilter on) 


L°ZZZ 


Memory overlay 



c 



142 



c 



c 



Examples 

We see that bit 6 is the left mouse button and bit 7 the 
joystick button. If the bit is »zero«, the button is pressed: 

Lef tMouseButton : 



BTST 


#6,$BFE001 


BEQ 


Lef tMou sePre ssed 


JoyButton : 




BTST 


#7,$BFE001 


BEQ 


JoyPressed 



To test the right mouse button we have to check bit 10 in 
»POTlNP« located at address »$dff016«:. 

RightButtonTest : 

BTST #10,$DFF016 . 
BEQ RightMousePressed 

If you bit-set or test in other registers, remember that »BSET«, 
»BTST« etc only work on byte size. So »BTST #10,??« is 
equivalent with »BTST #10-8,??«. 

When you are making non-system programs, programs that 
do not use the library and kickstart routines (most ga- 
mes/demos are programmed this way), I recommend you to 
use the source on the disk called »NonSysternStartUp.S«. 
This source provides you with an standard easy to use routine. 
An example of how to use this startup is shown in the source 
called »ScroIl Example. S« ' 

The startup routine is based on an interrupt. This interrupt 
(called »vertical blanking«) is activated each time the screen is 
redrawn on the monitor. This happens 50 times/second (In 
USA 60 times/second). We say that the computer shows 50 
frames/second. (Read in the Hardware Manual about piayfield 
hardware to understand this). With this interrupt you can acti- 
vate one or more routines. 
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In the »scroll« example mentioned above, the text on the 
screen is moved one time each frame. In one second you will 
see the scroller positioned on 50 different positions each time 
moved a little to the left. Because the fact that the eye can 
only perceive about 25 different frames/second, the 50 frames 
will be recognized as one smooth motion. 

This technic can be used with a lot of other things. You could 
draw a ball at one frame, delete the old ball and draw a new 
on a little different position on the next frame. In this way you 
can make a bounching ball or, if you change the shape of the 
ball with each frame, a little animation. 

To work properly, you will of course insert these routines at the 
correct place in the »NonSystemStartUp.S« source. 

First find these lines in the source: 

INTER: 

MOVEM.L D0-D7/A0-A6,~(A7) . ; Put 

; registers on stack 

LEA.L $DFF000,A6 
MOVE . L # SCREEN, $E0 (A6) 

; Place your interrupt routine here 

MOVE.W #$4020,$9C(A6) ; Clear 

; interrupt request 
MOVEM.L (A7)+,D0-D7/A0-A6 ; Get regis- 

; ters from stack 
RTE 

Insert the routine after the text »;--- Place y... «. 
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Drawing objects on the screen takes time. Because the object 
has to be redrawn 50 times/second to form a smooth motion, 
the routine must of course not take more than 1/50 second. If 
a routine takes more time you will in most cases not activate 
this from the interrupt. 

Let's say you have made a routine that can calculate a pic- 
ture, but this takes 30 -seconds, you would place this routine 
between the following two lines in the »startup« routine: 

;***** Your main routines ***** 

; ***** Main loop Test mouse button ***** 

Making programs' using the custom chips can only, 'be done if 
you can both code and know how the hardware works. Be- 
cause the Amiga hardware is very advanced it is not possible 
in this short chapter to give a close description of how it works. 
I advise you to read in one of the books "written about this 
subject. Following here is a example that can draw one object 
on the screen. 



11.3.1 Making an object 

To make animations on the Amiga you will find the biitter very 
handy. It is fast and not so difficult to use. Before' we can 
show you a programming example we must jook at the 
registers to control the biitter. : 

Add the »ADD« value to the base address »$dff000«: 
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NAME 


ADD 


R/W 


Function 






BLTCONO 

"bltconT™" 


$040 


W 


Blitter control register 






$042 


w 


Blitter control register 1 






BLTAFWM 


$044 


w 


Blitter first word mask for source A 






BLTALWM 


$046 


w 


Blitter last word mask for source A 




BLTCPT 


$048 


w ., 


Blitter source C pointer (longword) 




BLTBPT 


$04C 


w . 


Blitter source B pointer (longword) 




BLTAPT 


$050 


w 


Blitter source A pointer (longword) 




BLTDPT 


$054 


w 


Blitter dest. D pointer (longword) 




BLTSIZE 


$058 


w 


Blitter start and size (width, higth) 






BLTCMOD- 


$060 


w 


Blitter source C modulo 






BLTBMOD ' 


$062 


w 


Blitter source B modulo 




BLTAMOD 


$064 


w 


Blitter source A modulo 




BLTDMOD 


$066 


w 


Blitter dest D modulo 




BLTCDAT ' 


$ 7 - 


w 


Blitter source C data 




BLTBDAT 


$0 72 


w 


Blitter source B data 




BLTADAT 


$074 


w 


Blitter source A data 
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The bit-pattern for the two control registers is as follows: 



Bit . 


BLTCONO 


| BLTCON1 


Bit 


BLTCONO 


BLTCON1 


• 15 


ASH3 


| BSH3 . 


07 


■LF7 


X 


14 


ASH2 


| BSH2 


06 


LF6 


X 


13 


ASHl 


| BSH1 


05 


LF5 


X 


12 


ASHO . 


j BSHO 


04 


LF4 


EFE 


11 


USEA 


I x 


03 


LF3 


IFE 


10 


USEB 


X 


02 


LF2 


FCI 


09 


USEC 


X 


01 


LF1 


DESC 


08 


USED 


X 


00 


LFO 


LINE 



c 
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ASHO-3 


- Source A shift value 


BSHO-3 


- Source B shift value 


USEA-D 


- Bit pattern to select 


source A - 


- D. 


LFO-7 


- Logic function minterm 


select 




EFE 


- Exclusive fill enable 


IFE 


- . Inclusive fill enable 


FCI 


- Fill carry input 


DESC 


Descending bit 


LINE 


- Line mode (l=On) 



c 



The blitter has three sources (A, B, C) and one destination (D). 
IWhat the blitter generally does is to take data words from the 
three sources and join these three words together to one 
word. The way the three words are joined together is descri- 
bed by the »LF« byte (Bit 0-7 in »BLTCON0«). 

Let's say we have an object (Pattern) and a screen with the 
width of 40 bytes. We can use source »A« to point at the ob- 
ject data. We use destination »D« to point at the position on 
the screen where we want the object. If we just source »A« 
and destination »D« we would perform a block move, but we 
don't want the object to delete the old pattern on the screen. 
To prevent this we will have to use source »C«, this source 
must point at the same position on the screen as the destina- 
tion. The following three lines will set these three pointers 

MOVE.L #OBJECT,$DFF050 ; Source A 
MOVE.L #SCREEN, $DFF048 ; Source C 
MOVE.L " #SCREEN, $DFF054 /Destination D 



147 



ASM-ONE 



If the object is one word wide (2 bytes), we must set the 
modulo on source »C« and destination »D« to 40-2 bytes = 
38 bytes. The modulo on source »A« must be set to zero. 
Here we go: 



MOVE.W #0, $DFF064 
MOVE.W #38,$DFF060 
MOVE.W #38,$DFF066 



Modulo Source A 
Modulo Source C 
Modulo on Desti- 
nation D 



Now we need to set the controi registers, we start with 
BLTCON0. The shift value is set to zero (%0000), we have 
used A, C and D so the next four bits are set to »%1011«. 
The logical function bytes are set to »%11111010«. When the 
blitter joins the three source words in to one word, it looks at 
one bit at the time (the first bit in all three words). Three bits 
give a maximum number of 8 combinations. (2 A 3=8 that is 
why you find 8 »LF« bits). The bits are set according to the list 
below: 



C 



Bit 


A 


B 


c 


Desired result in D 


7 


1 


1 


1 


1 


6 


1 


1 





1 


5 


1 





1 


1 


4 


1 


b 





1 


3 





1 


1 


1 


2 





1 








1 








1 


1 


















c 
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We don't use source »B«, so we only have to concern about 
the four different combinations in A and C (11 = 1, 10 = 1, 01 
= 1 and 00 = .0). If you try going, think about these four combi- 
nations by saying to yourself: If a bit is set in the object word 
and a bit is set in the background word, then we want the 
result to be a set bit in the destination word etc. 

The result of the above considerations is that the »BLTCON0« 
must be set to: 

MOVE.W #%0000101111111010,$DFF040 

Control register 1 must be set to zero. 

M0VE. ? W #%0000000000000000,$DFF042 

To start the blitter you must write the size of the object into the 
register called »BLTStZE«. The size is calculated as 
»64*Hight+Width/2«. 

MOVE.W #64*8+2/2, $DFF058 

The above lines can be joined into one little program: 



MAKE_OB JECT : 
LEA.L 



WAIT: 



BTST 



BNE.B 



$DFF000,A6 



#14-8, $2 (A6) 



WAIT 



; Custom base to A6 

Is the blitter 
ready? 



MOVE.W #%0000101111111010 / $40(a6) 
MOVE.W #%0000000000000000,$42(a6) 



MOVE.L #OBJECT, $50 (a6) 
MOVE.L #SCREEN, $48 (a6) 
MOVE.L #SCREEN, $54 (a6) 



Source A 
Source C 
Destina- 
tion D 
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MOVE.W #0,$64(a6) 
MOVE.W #38,$60(a6) 
MOVE.W #38,$66(a6) 



Modulo source A 
Modulo source C 
Modulo destina- 
tion D 



MOVE.L #$FFFFFFFF,$44<a6) ; Don't mask 

; anything away 
MOVE.W #64*8+2/2, $58 (a6) ; Start 

; blitter 
RTS 



OBJECT: DC.W 
DC.W 
DC.W 
DC.W 
DC.W 
DC.W 
DC.W 
DC.W 



%0000000110000000 
%000000111100.0000 
%0100011001100010 
%0100111001110010 
%0111111111111110 

%oioooiiniioboio 

%0000001111000000 
%0000011111100000 



; Ob j ect date s 



c 



To see more examples of how to use the blitter, look in the 
files called »ScrollExample.S« and »LineExample.S«. 



o 
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To insure that you get exactly the assembler you want, a lot of 
options have been supplied. You find these options in the 
»Project« and the »Assembler« menus. 

The options are as follows: 



<: 



Option 


Presetting 


Short Name 


Rescue 


Off. 


RS 


Level 7 


Off 


L7 


NumLock 


On 


NL 


AutoAlloc 


On 


M 


\ ReqLibrary 


Off 


RL 


PrinterDump 


Off 


PD 


Interlace 


Off 


[L 


1 Bltplane 


Off 


1B 


Source .S 


On 


.S 


LineNumbers 


Off 


LN 


Autolndent 


On 


Al 


ShowSource 


On 


ss 


LlstFile 


Off 


LF 


! Pageing 


On 


PG 


Halt Page 


On 


HP 


All Errors 


Off 


AE 


Debug 


Off 


DB 


Label: 


Off 


L: 


i UCase=LCase 


On 


UL 


| Offset(A4} 


Off 


A4 


j DisAssemble 


. .-.On 


DA 


! OnlyAscii 


Off 


OA 


[ Comment 


Off- 


C 


f Close WB 


Off 


CW 



A close discription af ail these options will follow later. 
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It is possible to save a ^preference file« called 

»ASM-One.Pref«. 

This file will consist of a (+/-) meaning »on/off« followed by the 

»Short Name« of the option. Like this: 

-RS-L7+NL+AA+RL etc. 

After this row of preferences it is possible for you to place 
some text. This is done in the. following way: 

~RS~L7+NL+AA+RL\c\200\ 

This will allocate 200 kb of workspace in the chipmemory every 
time the assembler is loaded. Any- other command string can 
also be placed here. The sign »\« stands for <return>.The 
extension »!« allows to apply a suffix to the filename when 
saved. See preference »Source.S«. 

Close description of the individual options: 

Rescue 

The »rescue« option will rescue any program fault or crash in 
your program even if the system was shut down- (interrupts 
disabled, own copperlist etc). It will survive »division by zero« 
in a »3. level interrupts 

WARNING: This action can be dangerous for'the Amiga multi- C. .■ 

tasking system. But on the other hand, if you make non- 
system programs and a crash occured you would have to 
reset the Amiga, and restart, now at. least you have a chance 
to save the source. 
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Level 7 

This Level 7 option allows to break your program at any given 
time. Let's take an infinite loop. These programming bugs can 
now be stopped and the source saved. To activate the level 7 
exception you will have to get a soldering iron and a switch. If 
you haven't made a little electronics before look for a person 
who knows about. If you do it yourself you can damage your 
computer! 

If you got an Amiga 500, here is how you do it:< 

At the left side of the computer is a 86-pin connector behind a 
little shutter. Remove this and you will see the connector as 
shown below. 



C 



GND 


1 




2 






3 


4 






5 


6 






7 


8 
10 






9 






11 


12 






13 


14 






15 


16 














39 


40 


JPLO 




41 


42 


JPL1 


1 43 


44 . . 


JPL2 










83 


84 






85 


86 





L 
O 

w 

E 
R 
S 
I 

D 
E 



You get yourself 3 normal semi-conductors. (diodes) and a 
switch. Connect one diode to each IPL-line (positive end). 
Connect the 3 other legs to one. another and connect these to 
a switch. Connect the other pin of the switch to GND. See the 
schematic diagram below. 
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if you got an Amiga 2000, here is how you do it: Op 
computer. Find the five 1 00-pin expansion connectors that are 
placed next to one another. On the print board at one end of 
the connector is printed the number 1. (At the end that is 
turned to the machine). The connector will look somewhat like 
this: 



GND 


1 




2 






3 
5 


4 






6 




U 
P 


7 
9 


8 
10 


L 




P 


11 
13 


12 


w 


E 


14 


E 


R 
S 


15 


16 

40 


R 
S 


1 


39 


E-lnt7 . 1 


D 


99 


D 


E 


98 
100 


E 



if you connect pin 40 with a switch to pin you will have your 
»level 7 switch«. We hope it is possible to follow these instruc- 
tions, if you are not totally certain of how to do it, then don't. 
Wrong connection can be fatal. 

Note: No warranties are given that these connections are right. 
If they are wrong they might damage the machine or software. 
If you choose to make these connections the risk is yours' 
alone, not ours. 



O 
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NumLock 

With this option set on the numeric keyboard is turned into its 
alternate functions: 



7 


Home 


8 


Up 


9 


Page up 


4 


Left 


6 


Right 


1 


End 
AutoAlloc 


|2 


Down 


3 


Page down 



If you create a »DATA_C«-section the memory used for this 
section will automatically be allocated in chipmemory if 
»AutoAlloc« is on. Otherwise the normal workspace memory 
will be used, not concerning if it is chip- or fastmemory. 

Req Library 

The » Requester library « is a help library that creates the file 
requesters and the other small requesters. They are easy to 
use, but takes up a little memory {14 kb). If you don't like this 
you can turn it off. If it is turned off, the first time you load the 
assembler it is not loaded into memory. Otherwise it will just 
stay unused in the memory. 

PrinterDump 

This option activates output to the printer. If set, all text from 
the command line will be outputted to the printer. This option 
can also be toggled with »Amiga-P«. If you use the printer for 
the first time, the printer device will be loaded. 
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Interlace 

Shift display to »interlace«. If there is not enough memory 
available for this action, a »one bitplane mid-res window« will 
be opened instead. 

1 Bitplane 

Shift display to »one bitplane«. This will save some memory. 

But the cursor will become the same color as the text, and f 

therefore can be hard to find. 

Source .S 

If set, a ».S« will be appended to the filename eve.rytime you 
try to save. If you don't want the ».S«, you can delete it from 
the file name string everytime you save, or disable this option. 

The option »!« is avai liable in the "preference file«. The syn- 
tax is as follows: ; 

Syntax: !.<extension max.3 chars> 
e.g.: ; 

! .ASM 



The extension is the text that is appended' to the filename 
when saved. This text is however only appended when the 
»Source .S«-option is on. If the »Source .S«-option is off, no 
text is appended to the »SHOW«, »HIDE« gadgets in the re- 
quester library. . .... 

LineNunibers 

If this option is set, each. line will be shown with a number in 
the editor. Nothing else will be different. 
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Autolndent 

If on, »leading spaces/tabs« will be copied to the next line 

each time you press <retum>. This is helpful if you use a 
»leading tab« on each line. 

ShowSource 

When not set, you are able to trace programs without having 
the source. Or if you are tracing a program with a lot of .ma- 
cros, it is nice to watch the entire translation of the macro. . ; 

ListFile 

Each time you assemble, a list file will be created if this op- 
tion is set. The list file will consist of line number, memory ad- 
dress, memory content, assembly line and the symbol table. 

Paging 

If you want the list file divided into pages, select- this option. 
See the »ListFile« flag for more details. 

Halt Page 

If paging is turned on, you can choose that each page waits 
on a keyboard pression. See the »ListFile« flag for more de- 
( tails. 

All Errors 

Normally when a source is assembled, the assembling is bro- 
ken each time an error occurs. But if the option is choosen, all 
errors will be reported each time you assemble. If you got' a 
printer, our can output the errors to the printer. 
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Debug 

If you are debugging your source frequently, with the build-in- 
debugger, you can set this option on. it takes a little more me- 
mory but if on, the debugger does not have to reassemble 
the source. 

Label: 

ASM-ONE is macro assembler compatible. This means that C 

labels don't have to use colons. A command is distinguished 

from a label by the fact that a command cannot be placed at 

the first column. But some assemblers do not allow labels 

without colons but they allow commands to be placed at the 

first coloumn. If the »label:« option is set, sources like this can 

still be assembled. . . 

UCase=LCase 

Sometimes you might like to use the same name twice, if you 
clear this flag this is possible if you just use different capitals in 
the two names, like: 

DOSBase und DOSBASE 

They will normally be treated as the one and same name, but 
if the flag is cleared these two. names are different. 

DisAssemble 

When watching the source in the debugger, it might someti- 
mes be convenient .to watch a disassembled version of the 
next line because this enables you to check that the source 
line is translated correct. 
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OnlyAscii 

If you are watching an ASCII-dump and are searching for text 
strings, you are not interested in alternate characters. If 
»OnlyAscii« is selected these chars are shown as a spot. 

;Comment 

Normaly a comment is everything after a correctly ended in- 
struction. A instruction is ended with one or more blanks. But if 
a space by accident was put into the operand field, the part 
right of this space was in some cases treated like a comment. 
Example: 

MOVE.W dO,DataPtr +2 

Here »+2« is treated like a comment. To avoid these nasty 
errors, turn on the flag »;Comment«. In the preference file use 
»+;C«. 

Close WB 

If you set this on, the workbench screen will be closed. It is 
however only possible to close the workbench, if no task win- 
dow is opened on it (for example the CLI window). In the pre- 
ference file this option is called »CW«. 
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B. Recommended literature /Books 

This manual will not be enough if you really want to program 
the Amiga. The books that I would recommend are here listed 
with a short explanation. They can be .divided into two cate- 
gories: Special Amiga books and general MC68000 books: 



Hardware Reference Manual (Commodore) 

If you want to get a close description of how the hardware 
works on the Amiga, this is the book to get. It contains some 
direct code examples, but not so many. But if you can code 
some MC68000 code in advance, it is not difficult to translate 
what you read into code. 

Libraries and Devices (Commodore) 

tf you want to use the system on the Amiga, this manual tells 
you a lot about how the different libraries work. Nearly no 
matter what you code, a good understanding about how the 
system works is necessary. You use this book to get a under- 
standing about how to do different things about the system, 
but this book does not give that many assembler coding 
examples (most C examples), so you have to look a lot in the 
include files in the beginning. ■ 

Includes and Autodocs (Commodore) 

If you have bought "Libraries and Devices«, this is the next 
book to get. It's more specific and written in a schematic way. 
It also explains about the libraries, but gives a closer descrip- 
tion of the different library calls. It also tells what arguments go 
into what registers, when you call the different library routines. 
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Amiga System Programmers Guide (Abacus/Data Becker) 

This book is a mixture of both the » Hardware Martual« and 
the "Libraries and Devices* (the main subject is the hard- 
ware). It is different in the way that everything is explained with 
examples, but giving more examples of course cuts the num- 
ber of subjects. It will be a good substitute for the hardware 
manual (with nearly no exception), but if you are a really 
serious library system coder, it cannot replace the books 
»Libraries and Devices« and "Includes and Autodocs«. If you 
only want to buy one big book, this is it. 

Amiga Machine Language. (Abacus/Data Becker) 

This is a little book that covers a lot of subjects about coding in 
machine language on the Amiga. It is based on a lot of small 
routines using the libraries. Nearly all. small routines can be 
used together. It is easy to read and not so expensive. If. you 
do not want to spend much money but want a little closer ex- 
planation' about making windows, menus and gadgets, this 
book is good.but not a substitute for the Hardware Manual. 



Programming the MC68000 (Sybex/Steve Williams) 

This is v a really good book about coding programs with the 
MC68000. First it gives a realiy close description about all 
commands and addressing modes available. It has also gene- (_ 

ral program examples for the processor and discussions about 
how to make structured programs. 

Of course there are other books, and maybe even better 
books. But the above are just the, books I have found useful 
and think/hope that you can find useful too. 



162 



Appendix - Error messages 



C 



C 



C. Error messages 

When assembling a new program, you will probably get one or 
more error messages because of errors in your program. In 
order to correct these bugs you get a text that gives a very 
short explanation of what was found wrong. 

Here is a closer description of each of the error messages. 

1. Workspace Memory full 

The assembler has to use additional memory for labels, reioc- 
tables, op-code etc. It takes this memory from the prealloca- 
ted workspace memory. If not sufficient memory is available, 
this error message is issued. 

2. Address Reg. Byte/Logic 

An address register (An) has a restricted addressing ability. 
You can not access this register as a byte, and you cannot 
use this register in a logical operation {like »OR.W A1,D2«). 

3. Address Reg. Expected 

In some addressing modes you can only use an address regi- 
ster (e.g. (An), (An)+, -(An), nn(An.Rn)). In these modes where 
»An« is specified, you have to use an address register. Some 
commands like »LEA <ea>,An« etc. can also only use an ad- 
dress register as destination. 

4. Data reg. expected 

Like error 3 about address registers some instructions only ac- 
cept data registers as operands. 
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5. Comma expected 

When a command wants two operands or more you have to 
separate the arguments with commas. Some people like to 
put tabs between each argument. It is possible to put 
tabs/spaces after a comma, but not before. 

6. Double Symbol 

It is not possible to use the same name twice as a label or a 
constant. The only symbol that can be redefined is the 
»once« defined with the »SET« directive. 

7. Unexpected end of file 

A macro definition, a REPT-block or a IF-statement has to be 
ended with a »ENDM«, »ENDR« and »ENDC« statement. If 
the end of the program is reached before the matching end- 
statement, this error is issued. 

8. User made FAIL 

The assembler has a directive called »FAIL«, if this 1 is encoun- 
tered this is the error message you will get. You use this let's 
say to check the size of statements for a macro, if the sta- 
tements have an illegal size you are able to stop assembling 
and report this error. 

9. Illegal Command 

The command line understands a lot of different commands, 

but if you type an unknown command, this is illegal. C 

10. Illegal Address size 

Specifying a direct address can be done in two ways. If the 
address is of word size, the following is possible: »MOVE.L 
$4.W,A6«. The two legal sizes are ».W« and ».L«. 
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11. Illegal Operand 

A source line is divided into different fields. Label, Operator, 
Operands and Comment field. Each type requires a special 
syntax, see each type for a closer description. If an operand 
doesn't confirm to this description, It is illegal. 

12. Illegal Operator 

A source line is divided into different fields. Label, Operator, 
Operands and Comment field. A legal operator is an op-code, 
macro or a directive. If the operator isn't recognized as one of 
these types, it is an illegal operator. 

13. Illegal Section type 

There are three possible types of sections (»CODE«, »DATA« 
or »BSS«). These types are devided into subclasses: 

CODE_P, CODE J), CODE_F 

DATA_P, DATA„C, DATA_F 

BSS_P, BSS_C, BSS_F 

See the section »directive« for a closer description. Any other 
types are illegal. 

14. Illegal Operator in BSS area 

It is possible to make different types of sections (»CODE«, 
»DATA« or »BSS«). A »BSS« section is non-initialized, this 
means that it cannot. carry any constant values {it will be filled 
with zeros). An op-code or »DC«, »DCB« is code producing, 
and these are therefore illegal operators in a »BSS« area. 
»DS« {Define Storage) is non-code-producing and is therefore 
legal. 
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15. Illegal Order 

The command »MOVEM« takes a register list as argument 
(e.g. »D0-D3/D4«). The registers must be written in ascending 
order with data registers first. 

16. Illegal reg. size 

The address mode »nn(An,Rn)« has an optional size specifier 
on the »Rn« register. The size specifier can be one of the fol- 
lowing:. ».W« or ».L« (e.g. »10(A3,D0.W». 

17. Illegal Size 

Some commands have a size specifier (».B«, ».W« or ».L«). 
Some commands can only use one or two of these sizes. If 
the size is independent of the operands, the size is illegal. 

18. Illegal macro def. 

Trying to define a macro inside a macro is not possible. But it 
is still possible to use a macro inside a macro. 

19. Immediate operand ex. 

Some commands, have a special addressing mode. If one of 
its operands is limited to an immediate expression (#nnn), and 
you write something else, this is the error you get (e.g. 
»MOVEQ D0,D1«). 

20. Include Jam 

This is a very hazardous massage, because it only occurs if 
you try to include a new file during »pass two«. 

21. Macro overflow 

You can nest macros (one macro uses another macro) up to a 
level of 25. This restriction is set because the machine has a 
limited stack space. 
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22. Conditional overflow 
You can nest conditional statements up to a level of 25. This 

restriction is set because the machine has a limited stack 
space. 

23. Section overflow 
You can only use a limited number of sections (max. 255). 
This maximum is set to preserve memory. ■ 

24. Include overflow 

You can nest include files up to a level of 5. The standard 
include files only reach a level of 3. This restriction is set be- 
cause the machine has a limited stack space: 

25. Repeat overflow 

You can nest »REPT...ENDR« statements up to a level of 4. 

This restriction is set because of the limited stack space. . 

26. Double definition 

Using the directive »BASEREG« in order to define the same 
address register as a base register twice is not possible. ' 

27. Invalid Addressing Mode 

This is the general addressing error. If you get this either the 
source and/or destination are wrong. 

28. LOAD without ORG 

C You can assemble your data into an absolute memory loca- 

tion using the »ORG« statement, if you want the source to be 
assembled as if it was placed at the »ORG« address, but 

loaded into memory at another address, you use the »LOAD« 
statement. The assembler starts in a relative section. So using 
a »LOAD« statement without first having told the assembler to 
put the source at a absolute address, has no effect. 
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29. Missing Quote 

When you use text strings starting with a quote ( ' " * ) this text 
string also has to end with the same quote. To use a quote in 
the text, write two times in a row ( " "" " ). 

30. NO operand space allowed 

It is not possible to place tabs/spaces inside one operand. It is 
only possible to put tabs/spaces between two operands. So 
the following operand is not allowed: 10( aO , dO ). 

31. NOT a constant/label 

In calculations it is of course only possible to use constants or 
labels. With this I mean that it is impossible to use macro na- 
mes in a calculation. 

32. Not in Repeat area 

Trying to end a repeat area using an »ENDR« is of course an 
impossible action if you are not in a repeat area. 

33. Not in macro 

To use. a »ENDM«, »MEXIT« or »CMEXIT« directive trying to 
end a macro is not possible if you are not in a macro defini- 
tion. 

34. Out of Range bit 

The only way you can get this odd error message is from the 
command »shift« in memory. If you try to roll more than one 
bit at the time, you recieve this error message. 

35. Out of Range 3 bit 

Some commands have a 3 bit field {e.g. »ADDQ«, »SUBQ«). 
This can carry a value from 1 to 8 and a value out of this 
range is »Out of Range« 



C 



C 



168 



Appendix - Error messages 



36. Out of Range 4 bit 

A. command like »TRAP« has a 4 bit value field telling the 
instruction which vector to jump to. This equals a value from 
»$0« to »$f«. 

37. Out of Range 8 bit 

A command like »MOVEQ« has a 8 bit field telling the instruc- 
tion what signed value to put into the destination register. The 
signed 8 bit equals a value from -128 to 127. AN normal byte- 
C sized data will be accepted if the data is inside the range -256 

to 255. 

38. Out of Range 16 bit 

Signed word sized data can be in the range -32768 to 32767. 
Normal word sized data will be accepted if the data is inside 
the range -65536 to 65535. 

39. Relative Mode Error 

If try to use a relativ value as a constant (e.g. word size or in 
calculations other than »+ -«) this is the error message you will 
get. 

40. Reserved Word 

You can use nearly any name for your labels and macros. But 
register names are reserved, because it would be impossible 
to distinguish an addressing mode using the name »d0« as 
r an register from an addressing mode using »d0« as an ad- 

dress {e.g. »Move.W d0,d1«). 

41 . Right parenthes Expected 

If you specify an arithmetic expression or an addressing mode 
using brackets. 
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42. String expected 

If a directive wants a string as an argument you must give it as 
a string. 

43. Undefined Symbol 

Using a not defined symbol will cause this error. The only al- 
ways defined symbols are the registers and »NARG« (see the 
macro directive). 

44. Register Expected 

Some commands can only accept a register as an argument. 
So if anything else is specified, this is the error message you 
get. 

45. Word at Odd Address 

Trying to assemble an »op-code« at an »odd boundary «, 
causes an »Word at Odd Address« error. This is because the 
MC68000 family is restricted to run commands on an even 
boundary. 

46. Not local area 

Local labels can only be placed after a global label. So trying 
to place a local label as the first label in your source will cause 
this error. 

47. Code moved during pass 2 

This is a critical error. »Pass« is used to define all labels to 
their appropriate value. »Pass two« is used to put »amm« 
code down into memory using all the right values from the de- 
fined labels. If suddenly a label points to another value during 
pass two something is very wrong. Usually this error occures if 
you have messed up some conditional assembly directives. 
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48. Bcc.B out of range in Macro 

Normally »Bcc.B« commands will be forced to word (».W«) if 
the branch is out of range. But because this is not done in 
macros, you get this error. If you want to be sure that a branch 
is »byte size« , place, the branch in a macro. 

49. Out of range (20 to 100) 

Using the command »page length «(PLEN) takes a value 
between 20 and 100 as an argument. 

50. Out of range (60 to 132) 

Using the command »line length« (LLEN) takes a value bet- 
ween 60 and 132 as an argument. 

51. Linker limitation 

If you use »XREPs« it is not possible to use calculation bet- 
ween two »XREF's«. 



Possible errors occuring during I/O activity: 

52. File Error 

The file was either not found or there was an error in the file 
that prevented it from beeing loaded. 

53. No Files 

Using the line command directory command »V - View« will re- 
(^ turn this message if the disk is empty. 

54. No Object 

If you have' used »XREF« or »XDEF« in your source, it pre- 
vents an object file from beeing saved. This error is also retur- 
ned if you haven't assembled the source (having edited to 
much in the source after assembling it last time). 
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55. No File Space 
The disk is full. 

56. Printer Device Mission 

If you want to print something, the computer has to load: 
"Printer. Device«, » Serial. Device «, "Parallel. Device« and the 
"printer configuration« from the disk. If one of these files is 
missing, printing is aborted. ■■ 

57. Req.Library not found f 

This assembler uses a library placed on the disk, it is optional 
if you want to use this library. But if you have set the flag 
(default) telling the assembler to use this library, and this 
library isn't placed on the disk, the assembler will tell you this 
error message. This error can occur if you have booted from 
the workbench disk without copying »req.library« on to the 
workbench. 

58. Illegal Path 

You get this message if you use the intern »V - View« direc- 
tory, specifying an non-existing directory. 

59. Illegal Device 

The built in disk commands »read/write« »sector/track« have 
an optional device specification (0 - 3). If the device does not 
exist, the device is illegal. 

60. Write Protected C 

Like »illegal device« this is an error from the »track disk de- 
vices Trying to write a sector or track on a write protected disk 
will cause this message. 
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61. No disk in drive 

Like "illegal device« this is an error message from the »track 
disk device«, trying to write a sector or track on an empty drive 
will cause this message. 

62. Not done 

Cancelling an operation, will cause this message. Normally this 
is done by pressing <esc>. 
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D. Instruction timings 

If you want to optimize very time-critical sections of your code 
this appendix can come in handy. Here it is possible to calcu- 
late all instruction evaluation times. The time you get here is in 
cycles. The normal Amiga run at a clock frequence of 7.16 
MHz (7.14 MHz in Europe). So if you want to calculate how 
much time your routine takes, divide the number of clock 
cycles by the clock frequence like this: 

ExeTime = Cycles/7160000 

So if your routine uses 10000 cycles, it will execute in 0.013 
sec. 

How to use the tables: 

First find your instruction. Make sure that you have found the 
right size and right addressing mode. If there is an »+« after 
the cycle value you will have to add the effective address cal- 
culation time. (<ea> time). 

Here are a few precalculated instructions: 

ADD.L D0,10(Al,Dl.W) = 12 + 14 = 26 cycles 
MOVE.W (A0)+,100 (A2) = 18 cycles 
ADD.L DO, DO =8 cycles 
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Table D.I. 
Effective Address Calculation timing 



<ea> 


Byte/Word 


Long 


Dn 








An 








(An) 


4 


8 


(An) + 


4 


8 


"(An) 


6 


10 | 


dl6 (An) 


8 


12 


d8 (An,Rn) 


10 


14 


xxxx . W 


8 


12 


xxxx . L 


12 


16 


dl6{PC) 


8 


12 


d8 (PC,Rn) 


10 


14 


#xxxx 


4 


8 
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Table D.2, Move Byte and Word Instruction Clock 
Periods 



SrcVDest 


Dn 


An 


(An) 


(An)+ 


•(An) 


d16(An) 


d8(An,Rn) 


XXX.W 


xxx.L 


Dn 


4 


4 


8 


8 


8 


12 


'* 14 


12 


16 


An 


4 


4 


8 


8 


8 


12 


14 


12 


16 


(An) 


8 


8 


12 


12 


12 


16 


18 


16 


20 


(An)+ 


8 


8 


12 


12 


12 


16 


18 ' 


16 


20 


-(An) 


10 


10 


14 


14 


14 


18 


20 


18 


22 


d16(An) 


12 


12 


16 


16 


16 


20 


22 


20 


24 


d8{An,Rn) 


14 


14 


18 


18 


18 


22 


24 


22 


26 


XXXX.W 


12 


12 


16 


16 


16 


20 


22 


20 


24 


XXXX.L 


16 


16 


20 


20 


20 


24 


26 


24 


28 


d16(PC) 


12 


12 


16 


16 


16 


20 


22 


20 


24 


d8(PC,Rn} 


14 


14 


18 


18 


18 


22 


24 


22 


26 


#xxxx 


8 


8 


12 


12 


12 


16 


18 


16 


20 
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Table D.3. 
Move Long Instruction Clock Periods 



Src\Dest 


Dn 


An 


(An) 


(An)* 


.-(An) 


d16(An) 


d8(An,Rn) 


xxx.W 


xxx.L 


Dn 


4 


4 


12 


12 _ 


!" 14 


16 


18 


16 


20 


An 


4 


4 


12 


12 


! 14 


16 


18 


16 


20 


(An) 


12 


12 


20 


20 


20 


24 


26 


24 


28 


(An)+ 


12 


12 


20 


20 


i 20 


24 


26 


24 


28 


-(An) 


14 


14 


22 


22 


22 


26 


28 


26 


30 


d16(An) 


16 


16 


24 


24 


: 24 


28 


30 


28 


32 


d8(An,Rn) 


18 


.18 


26 


26 


i 26 


30 


32 


30 


34... 


XXXX.W 


16 


16 


24 


24 


24 


28 


30 


28 


32 


XXXX.L 


20 


20 


28 


28 


: 28 


32 


34 


32 


36 


d16(PC) 


16 


16 


24 


24 


24 


28 


30 


28 


32 


d8(PC,Rn) 


18 


18 


26 


26 


26 


30 


32 


30 


34 


#xxxx 


12 


12. 


20 


20 


20 


24 


26 


24 


28 



Table D.4. Arithmetic, Logical and Compare 
Instruction Clock Periods 



Opcode 


Size 


<ea>,An 


<ea>,Dn 


Dn,<ea> 


ADD 


BW 


8+ 


4+ 


8+ 




L 


6+" 


6+" 


12+ 


AND 


BW 


- 


4+ 


8+ 




L 


- 


6+" 


12+ 


CMP 


BW 


6+ 


- 4+ 


j 




L 


6-1- . 


6+ 


- 


DIVS 


W 


- 


158+ * 


- 


DIVU 


w 


-1 


40+* 


- 


EOR 


BW 


- 


4+ 


• 8+ 




L 


■ - 


8+ 


12+ 


MULS 


W 


- 


70+* 


■■ - 


MULU 


W 


- 


70+* 


- 


OR 


BW 


- 


4+ 


8+ 




L 


- 


. 6+** 


12+ 


SUB 


BW 


8+ 


4+ 


8+ 




L 


6+** 


6+ " 


12+ 



+ Add Effective address calculation time 

* Maximum value 

" Total of 8 cycles if <ea> is data register direct. 
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Table D.5. 
Immediate Instruction Clock Periods 



Opcode 


Size 


#,Dn 


#,An 


#,<ea> 


ADD! 


BW 


8 


- 


12+ 




L 


16 


- 


20+ 


ADDQ 


BW 


4 


8 


8+ 




L 


8 


8 


12+ 


ANDI 


BW 


8 


- 


12+ 




L 


16 


- 


20+ 


CMPI 


BW 


8 


8 


8+ 




L 


14 


14 


12+ 


EORI 


BW 


8 


- 


12+ 




L . 


16 


- 


20+ 


MOVEQ 


L 


4 


- 


■ 


0R1 


BW 


8 


- 


12+ 




L 


16 


- 


20+ 


SUB! 


BW 


8 


- 


12+ 




L 


16 


- 


j 20+ . 


SUBQ 


BW 


4 


8 


8+ 




L 


8 


8 


12+ 
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Table D.6. 
Single Operand Instuction Clock Periods 



Opcode 


Size 


Register 


Memory 


OB 


BW 


4 


8+ 




L 


6 


12+ 


NBCD 


B 


6 . | 8+ 


NEG 


BW 


4 j 8+ 




L 


6 


12+ 


NEGX 


BW 


4 


8+ 




L 


6 


12+ 


NOT 


BW 


4 • ■ 


8+- 




.L 


6 


12+ 


Sec 


B false 


4 


8+ 




Btrue- 


6 


8+ 


TAS 


B 


4 j 10+ 


TST 


B W 4 4+ 


■ " " 




L ■• 


■4- | 4+ 
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Table D.7. 

Shift and Rotate Instruction Clock Periods 



Opcode 


Size 


Register 


Memory 


ASR 


BW 


6+2n 


8+ 


ASL 


L 


8+2n 


- 


LSR 


BW 


6+2n 


8+ 


LSL 


L 


8+2n 


- 


ROR 


BW 


6+2n 


8+ 


ROL 


L 


8+2n 


- 


ROXR 


BW 


6+2n 


8+ 


ROXL 


L 


8+2n 


| 
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Table D.8. 

Bit Manipulation Instruction Clock Periods 



Opcode 


Size 


Dn,Dn 


Dn,<ea> 


#n,Dn 


#n,<ea> 


BCHG 


B 


- 


8+ 


. - 


12+ 




L 


8* 


- ' 


12* 


- 


BCLR 


B 




8+ 


- 


12+ 




L 


10* 


- 


14* 


- ■ 


BSET 


B 


- 


8+ 


- 


12+ 




I 


8* 


- 


12* 


- 


BTST 


B 


- 


4+ 


- 


8+ 




L 


6* 


- 


10* 


| 



+ Add Effective address calculation time 
* Maximum value 
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Table D.9. 
Branch and Trap Instruction Clock Periods 



Opcode 


Disp 


Taken 


Not Taken 


Bcc 


B 


10 


8 




L 


10 


12 


BRA 


B 


10 


- 




W 


10 


- 


BSR 


B 


18 


- 




W 


18 


- 


DBcc 


ccTrue 


- 


12 




cc False 


10 


14 


CHK 


- 


43+* 


8+ 


TRAP 


- 


34 


- 


TRAPV 


- 


34 


4 
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Add Effective address calculation time 
Maximum value 



Table D.10. JMP, JSR, LEA, PEA and MOVEM 
Instruction Clock Periods 



[Opcode 


Size 


(An) 


(AnK 


-(An) 


d16(An) 


d8(An,Rn) 


xx.W 


xx.L 


d16(PC) 


d8(PC,Rn) j 


jjMP 


- 


8 


- 


- 


10 


14 


10 


12 


10 


14 


JJSR 


- 


16 






18 . 


22 


18 


20 


18 


24 


LEA 


.- 


. , 4 


- 




8 


12 . 


8 


12 


8 


12 


JPEA 


-. 


. 12 




- 


16 


20 


16 


20 


16 


20 


JMOVEM 


W 


12+4n 


12+4n 


- 


16+4(1 


18+4n 


16+4n 


20+4n 


16+4n 


18+4n 


j M-R 


L 


12+8n 


12+8n 




16+8n 


18+8n 


16+8n 


20+8n 


16+8n 


18+8n 


|movem 


W 


8+4n 




8+4n 


12+4n 


14+4n 


12+4n 


16+4n 


- 


- 


j R-M 


L 


8+8n 


- 


8+8n 


12+8n 


14+8n 


12+8n 


16+8n 


- 
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n is the number of registers to move 
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Table D.11. 

Multiprecision instruction Clock Periods. 



Opcode 


Size 


Dn,Dn 


M,M 


ADDX 


B W 


4 


18 




L 


8 


30 


CMPM 


B W 


- 


12 




L 


- 


20 


SUBX 


B W 


4 


18 




L 


8 


30 


ABCD 


B 


6 


18 


SBCD 


B 


6 


18 



Table D.12. 
Miscellaneous Instruction Clock Periods 



Opcode 


Size 


Rn 


<ea> 


Rn,<ea> 


<ea>,Rn 


MOVE SR,? 


- 


6 


8+ 


- 


- 


MOVE ?,CCR 


- 


12 


12+ 


- 


- 


MOVE ?,SR 


- 


12 


12+ 


- 


- 


MOVEP 


w 


- 


- 


16 


16 




L 


- 


- 


24 


24 


EXG 


- 


6 


- 


- 


- 


EXT 


W 


4 


- 


- 


- 




L 


4 


- 


- 


- 


LINK 


- 


16 


- 


- 


- 


MOVE USP,? 


- 


4 


- 


• 


- 


MOVE ?,USP 


- 


4 


- 


- 


- 


NOP 


- 


4 


- 


- 


- 


RESET 


- 


132 


- 


- 


- 


RTE 


- 


20 


- 


- 


- 


RTR 


- 


20 


- 


• 


- 


RTS 


- 


16 


- 




- 


STOP 




4 




- 


- 


SWAP 


- 


4 


- 


- 


- 


UNLK 


- 


12 


- 


, 


- 



Add Effective address calculation time 
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Table D.13. 
Exception Processing Clock Periods 



Exception 


Periods 


Address Error 


50 


Bus Error 


50 


Interrupt 


44* 


Illegal Instruction 


34 


Privileged Instruction 


34 


Trace 


34 



The interrupt acknowledge bus cycle is assumed to take 4 clock cycles. 
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Address register 23 
Address registers 95 
Animation 144 
ASCII code 24 
ASM-ONE 

Basic functions 9 

Overview 8 
Assembler 49 

Assembly Control 62 

Comment 53; 51 

Conditional assembly 76 

Data definition 67 

Directives 57 

Executable file 50 

Expressions 54 

External symbols 83 

General directives 84 

Label field 52 

Linkkfile 50 

Listing control 80 

Local labels 52 

Macro directives 73 

Opcode Field 53 

Operand Field 53 

Options 49 

Programs 51 

Symbol definition 70 ' 



B 

BCD numbers 112 
Binary notation 17 
Blitter 145 
Books 161 
Bubble Sort 129 



Command line 

Add workspace memory 37 

ASCII dump 40 

Assemble debug 43 

Assemble memory 40 

Assemble optimize 43 

Assemble source in' editor 43 

Assemble to memory 43 

Bottom of file 38 

Calculate boot checksum 46 

Calculate value 47 

Compare 41. . 

Copy 41 

Direct output 47 

Disassemble 39; 40 

Edit memory 39 

Fill 41 

Go to address 44 

Hex dump 40; 41 

Insert 36 

Insert ASCII 42 

Insert disassemble 42 
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Command line 

Insert hex dump 42 

Jump to address 44 

Load extern files 46 

Look for text 38 

Old source 33 

Overview 30 

Print number of lines from 

cursor 39 
Quit assembler 37 
Read 33 
Read binary 34 
Read object 34 
Read sector 45 
Read track 45 
Search 41 

Single step n steps 44 
Symbol table print 43 
Top of file/jump to line 38 
Update file 36 
View directory 46 
View/edit register values 44 
Write 35 
Write binary 35 
Write object 36 
Write preferences 37 
Write sector 45 
Write track 45 
Zap file 36 

Zap include memory 36 
Zap number of lines from 

cursor 38 
Zap source 33 



Data register 22; 95 
Debugger 87 

AddWatch 88 

B.P. Addr 90 

B.P. Mark 90 

DelWatch 89 

DisAssem 90 

Edit regs 88 

Enter 88 

JumpAddr 89 

JumpMark 90 

ShowSource 90 

Step n 88 

Step One 87 

Zap B.P. 90 

ZapWatch 89 
Delete 

Screen memory 126 
Directive 

>EXTERN 86 

AUTO 86 

BASEREG 65 

BLK 68 

CMEXIT 75 

CNOP 76 

DC 67 

DCB67 

DR 69 

DS 68 

ELSE 79 

END 65 

ENDC 79 

ENDM 74 

ENDOFF 64 
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Directive 

ENDR 75 
EQU70 
EQUR 70 
FAIL 81 
IDNT 86 
IF 77 
IF1 79 
IF2 79 
IFB78 
IFD78 
IFEQ 77 
IFGE 77 
iFGT 77 
IFLE 77 
IFLT 77 
IFNB 79 
IFNC 78 
[FND 78 
IFNE 77 
INCBIN 84 
INCDIR85 
INCLUDE 84 
JUMPPTR 84 
LIST 80 
LLEN 80 
LOAD 63 
MACRO 73 
MEXIT 74 
NARG 74 
NOLIST 80 
NOPAGE 80 
ODD 76 
OFFSET 64 
ORG 63 
PAGE 80 
PLEN 80 



Directive 

PRINTT81 
PRINTV 82 
REG 71 
REPT 75 
RORG 63 
RS71 
RSSET 72 
SECTION 62 
SET 70 
SPC81 
TTL81 
XDEF 83 
XREF 83 
Dos.library 134 



Editor 

Jump to mark » 29 
Mark 1,2,3 29 
Overview 25 
Shortcut 25 

Start macro creation 29 
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Error messages 1 63 

Address Reg. Byte/Logic 163 
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Bcc.B out of range in Macro 

171 
Code moved during pass 2 

170 
Comma expected 164 
Conditional overflow 167 
Data reg. expected 163 
Double definition 167 
Double Symbol 164 
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Error messages 
File Error 171 
Illegal Address size 1 64 
Illegal Command 164 
Illegal Device 172 
Illegal macro def. 166 
Illegal Operand 165 
Illegal Operator 165 
Illegal Operator in BSS area 

165 
Illegal Order 166 
Illegal Path 172 
Illegal reg. size 166 
Illegal Section type 165 
Illegal Size 166 
Immediate operand ex. 166 
Include Jam 166 
Include overflow 1 67 
Invalid Addressing Mode 167 
Linker limitation 171 
LOAD without ORG 167 
Macro overflow 1 66 
Missing Quote 168 
No disk in drive 173 
No File Space 172 
No Files 171 
No Object 1 71 
NO operand space allowed 

168 
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Not done 173 
Not in macro 168 
Not in Repeat area 168 
Not local area 1 70 
Out of range (20 to 100) 171 
Out of range (60 to 132) 171 
Out of Range bit 168 



Error messages 
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Out of Range 3 bit 168 
Out of Range 4 bit 169 
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Printer Device Mission 172 
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Relative Mode Error 169 
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Req.Library not found 172 
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169 
Section overflow 167 
String expected 170 
Undefined Symbol 170 
Unexpected end of file 164 
User made FAIL 164 
Word at Odd Address 170 
Workspace Memory full 163 
Write Protected 172 
Examples 

»GettingStarted.S« 13 
Delete, Copy and Compare 

126 
General Examples 123 
Hardware Programming 138 
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Mouse button 143 
Sorting 129 
System Programming 132 
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H 
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I 
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L 
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N 
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143; 144 
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Start 
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Example 13 
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V 
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143 
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